simdjson_key_value
(PECL simdjson >= 2.0.0)
simdjson_key_value — Decodes the value of a JSON string located at the requested JSON pointer.
説明
Decodes and returns the value found at the requested JSON pointer.
パラメータ
json
-
The
json
string being queried and decoded.This function only works with UTF-8 encoded strings.
This function parses valid inputs which json_decode() can decode, provided that they are less than 4 GiB long.
key
-
The JSON pointer string.
associative
-
When
true
, JSON objects will be returned as associative arrays; whenfalse
, JSON objects will be returned as objects. depth
-
Maximum nesting depth of the structure being decoded. The value must be greater than
0
, and less than or equal to2147483647
. Callers should use reasonably small values, because larger depths require more buffer space and will increase the recursion depth, unlike the current json_decode() implementation.
戻り値
Returns the part of the value encoded in json
that key
refers to in appropriate
PHP type. Values true
, false
and
null
are returned as true
, false
and null
respectively.
エラー / 例外
If json
or key
is invalid,
or key
could not be found within json
,
a SimdJsonException is thrown as of PECL simdjson 2.1.0,
while previously, a RuntimeException was thrown.
If depth
is outside the allowed range,
a SimdJsonValueError is thrown as of PECL simdjson 3.0.0,
while previously, an error of level E_WARNING
was raised.