array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.simdjson-key-value.php', 1 => 'simdjson_key_value', 2 => 'Декодирует значение строки JSON, расположенной по запрошенному указателю JSON', ), 'up' => array ( 0 => 'ref.simdjson.php', 1 => 'Функции Simdjson', ), 'prev' => array ( 0 => 'function.simdjson-key-exists.php', 1 => 'simdjson_key_exists', ), 'next' => array ( 0 => 'class.simdjsonexception.php', 1 => 'SimdJsonException', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/simdjson/functions/simdjson-key-value.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

simdjson_key_value

(PECL simdjson >= 2.0.0)

simdjson_key_value — Декодирует значение строки JSON, расположенной по запрошенному указателю JSON

Описание

simdjson_key_value(
    string $json,
    string $key,
    bool $associative = false,
    int $depth = 512
): mixed

Декодирует и возвращает значение, найденное в запрошенном указателе JSON.

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

json
Запрашиваемая и декодируемая строка (string) в формате json. Функция работает только со строками в кодировке UTF-8. Функция анализирует допустимые входные данные, которые функция json_decode() может декодировать, при условии, что их длина не превышает 4 Гб.
key
Строка (string) указатель JSON.
associative
При значении true, объекты JSON будут возвращены как ассоциативные массивы (array); при значении false, объекты JSON будут возвращены как объекты (object).
depth
Максимальная глубина вложенности декодируемой структуры. Значение должно быть больше 0 и меньше или равно 2147483647. Вызывающие команды должны использовать достаточно маленькие значения, поскольку большая глубина требуют больше места в буфере и увеличивают глубину рекурсии, в отличие от текущей реализации функции json_decode().

Возвращаемые значения

Возвращает часть значения, закодированное в параметре json на которую ссылается ключ key в соответствующем PHP-типе. Значения true, false и null возвращаются как true, false и null соответственно.

Ошибки

Если параметр json или key недопустимы или параметр key не удалось найти в параметре json, то начиная с версии PECL simdjson 2.1.0 выбрасывается исключение SimdJsonException; ранее выбрасывалось исключение RuntimeException.

Если параметр depth находится вне допустимого диапазона, то начиная с версии PECL simdjson 3.0.0 выбрасывается исключение SimdJsonValueError, тогда как ранее выдавалась ошибка уровня E_WARNING.

Смотрите также