PHP 日本大会 2024

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 类型表示。值 truefalsenull 分别作为 truefalsenull 返回。

错误/异常

如果 jsonkey 无效,或者在 json 中找不到 key,则从 PECL simdjson 2.1.0 开始将抛出 SimdJsonException,而在此之前,则会抛出 RuntimeException

如果 depth 超出允许的范围,则从 PECL simdjson 3.0.0 开始将抛出 SimdJsonValueError,而在此之前,则会引发级别为 E_WARNING 的错误。

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top