simdjson_is_valid

(PECL simdjson >= 2.0.0)

simdjson_is_valid — Перевіряє, чи є рядок JSON коректним.

Опис

simdjson_is_valid(string $json = false, int $depth = 512): bool

Приймає рядок, закодований JSON і повертає true, якщо він коректний.

Список параметрів

json

Строка (string) в форматеjson для перевірки.

Функція працює тільки з рядками кодування UTF-8.

Функція аналізує допустимі вхідні дані, які функція json_decode() може декодувати, за умови, що їхня довжина не перевищує 4 Гб.

depth

Максимальна глибина вкладеності структури, що декодується. Значення має бути більшим і менше чи одно 2147483647. Команда, що викликає, повинна використовувати досить маленькі значення, оскільки велика глибина вимагають більше місця в буфері і збільшують глибину рекурсії, на відміну від поточної реалізації функції json_decode()

Значення, що повертаються

Повертає true, якщо параметр json є коректним рядком JSON, інакше повертає false

Помилки

Якщо параметр json більше 4 ГБ, то починаючи з версії PECL simdjson 2.1.0 викидається виняток SimdJsonException; раніше викидався виняток RuntimeException

Якщо параметр depth знаходиться поза допустимим діапазоном, то починаючи з версії PECL simdjson 3.0.0 викидається виняток SimdJsonValueError, тоді як раніше видавалася помилка рівня E_WARNING

Приклади

Приклад #1 Приклад использованияsimdjson_decode()

Loading...
▶

Результат виконання наведеного прикладу:

bool(true)
bool(false)

Приклад #2 Ошибкиdepth

Loading...
▶

Результат виконання наведеного прикладу:

bool(true)
bool(false)

Примітки

Зауваження :

Специфікація JSON - це не JavaScript, а підмножина JavaScript.

Зауваження :

У разі виникнення помилки декодування викидається виняток SimdJsonException, аSimdJsonException::getCode() і SimdJsonException::getMessage() можуть бути використані визначення точної природи помилки.

Дивіться також

• json_encode() - Повертає JSON-подання даних
• json_decode() - Декодує рядок JSON