array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.simdjson-key-value.php', 1 => 'simdjson_key_value', 2 => 'Decodifica o valor de uma string JSON localizada no ponteiro JSON solicitado', ), 'up' => array ( 0 => 'ref.simdjson.php', 1 => 'Funções de 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' => 'pt_BR', '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 — Decodifica o valor de uma string JSON localizada no ponteiro JSON solicitado

Descrição

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

Decodifica e retorna o valor encontrado no ponteiro JSON solicitado.

Parâmetros

json
A string json sendo consultada e decodificada. Esta função só funciona com strings codificadas em UTF-8. Esta função analisa entradas válidas que json_decode() pode decodificar, desde que tenham menos de 4 GiB de comprimento.
key
A string de ponteiro JSON.
associative
Quando true, os objetos JSON serão retornados como arrays associativos; quando false, os objetos JSON serão retornados como objects.
depth
Profundidade máxima de aninhamento da estrutura que está sendo decodificada. O valor deve ser maior que 0, e menor ou igual a 2147483647. Os chamadores devem usar valores razoavelmente pequenos, porque profundidades maiores exigem mais espaço de buffer e aumentarão a profundidade de recursão, ao contrário da implementação atual de json_decode().

Valor Retornado

Retorna a parte do valor codificado em json à qual key se refere no tipo PHP apropriado. Os valores true, false e null são retornados como true, false e null respectivamente.

Erros/Exceções

Se json ou key for inválido, ou key não puder ser encontrado em json, uma SimdJsonException será lançada a partir do PECL simdjson 2.1.0, enquanto anteriormente, uma RuntimeException era lançada.

Se depth estiver fora do intervalo permitido, um SimdJsonValueError será gerado a partir do PECL simdjson 3.0.0, enquanto anteriormente, um erro de nível E_WARNING era gerado.

Veja Também