simdjson_key_value

(PECL simdjson >= 2.0.0)

simdjson_key_value — 解碼位於請求的 JSON 指標的 JSON 字串值。

simdjson_key_value(
    字串 $json,
    字串 $key,
    布林值 $associative = false,
    int $depth = 512
): mixed

解碼並返回在請求的 JSON 指標處找到的值。

json

被查詢和解碼的 json 字串。

此函數僅適用於 UTF-8 編碼的字串。

此函數可以解析 json_decode() 可以解碼的有效輸入，前提是它們的長度小於 4 GiB。

key

JSON 指標字串。

associative

當設為 true 時，JSON 物件將作為關聯式陣列返回；當設為 false 時，JSON 物件將作為物件返回。

depth

被解碼結構的最大嵌套深度。該值必須大於 0，且小於或等於 2147483647。呼叫者應使用合理的小值，因為較大的深度需要更多的緩衝區空間，並且會增加遞迴深度，這與目前的 json_decode() 實作不同。

以適當的 PHP 類型返回 json 中由 key 指示的部分值。值 true、false 和 null 分別以 true、false 和 null 返回。

如果 json 或 key 無效，或者在 json 中找不到 key，則從 PECL simdjson 2.1.0 開始會拋出 SimdJsonException，而先前會拋出 RuntimeException。

如果 depth 超出允許範圍，則從 PECL simdjson 3.0.0 開始會拋出 SimdJsonValueError，而先前會引發層級為 E_WARNING 的錯誤。

此頁面沒有使用者提供的註釋。