International PHP Conference Munich 2025

simdjson_key_value

(PECL simdjson >= 2.0.0)

simdjson_key_valueDecodifica 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

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top