simdjson_key_value

(PECL simdjson >= 2.0.0)

simdjson_key_value — 解码位于请求的 JSON 指针处的 JSON 字符串的值。

simdjson_key_value(
    字符串 $json,
    字符串 $key,
    布尔值 $associative = false,
    整数 $depth = 512
): 混合

解码并返回在请求的 JSON 指针处找到的值。

json

正在查询和解码的 json 字符串。

此函数仅适用于 UTF-8 编码的字符串。

此函数解析有效的输入，这些输入可以被 json_decode() 解码，前提是它们的长度小于 4 GiB。

key

JSON 指针字符串。

associative

当 true 时，JSON 对象将作为关联的数组返回；当 false 时，JSON 对象将作为对象返回。

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 的错误。