array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.simdjson-key-value.php', 1 => 'simdjson_key_value', 2 => 'Décode la valeur d\'une chaîne JSON située à l\'indicateur JSON demandé.', ), 'up' => array ( 0 => 'ref.simdjson.php', 1 => 'Fonctions 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' => 'fr', '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 — Décode la valeur d'une chaîne JSON située à l'indicateur JSON demandé.

Description

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

Décode et renvoie la valeur trouvée à l'indicateur JSON demandé.

Liste de paramètres

json
Le json string à interroger et décoder. Cette fonction ne fonctionne qu'avec des chaînes encodées en UTF-8. Cette fonction analyse les entrées valides que json_decode() peut décoder, à condition qu'elles soient inférieures à 4 Go de longueur.
key
Le string du pointeur JSON.
associative
Lorsque true les objets JSON seront retournés sous forme de tableau associatifs ; lorsqu'ils sont false, les objets JSON seront retournés sous forme d'objets.
depth
La profondeur maximale de la structure à décoder. La valeur doit être supérieure à 0, et inférieure ou égale à 2147483647. Ceux qui appellent cette fonction devraient utiliser des valeurs raisonnablement petites, car des profondeurs plus importantes nécessitent plus d'espace tampon et augmenteront la profondeur de récursion, contrairement à l'implémentation actuelle de json_decode().

Valeurs de retour

Renvoie la partie de la valeur encodée dans json que key référence dans le type PHP approprié. Les valeurs true, false et null sont renvoyées respectivement comme true, false et null.

Erreurs / Exceptions

Si json ou key est invalide, ou si key n'a pas pu être trouvé dans json, une SimdJsonException est lancée à partir de PECL simdjson 2.1.0, alors qu'auparavant, une RuntimeException était lancée.

Si depth est en dehors de la plage autorisée, une SimdJsonValueError est lancée à partir de PECL simdjson 3.0.0, alors qu'auparavant, une erreur de niveau E_WARNING était lancée.

Voir aussi