(rontolisp) docs
← rontolisp パッケージの関数

rontolisp:json-value

(rontolisp:json-value document &rest path) / (rontolisp:json-value address size &rest path)

JSON ドキュメントから値を 1 つ読み出します。 rontolisp:json-span がパスの先に見つけた値に対して rontolisp:json-parse が返すものと、値が見つかった ことを示す t を返します。Lisp の値になるのはその値だけで、ドキュメントの 残りは検査されて読み飛ばされます。そのため大きな本文から数個のフィールドを 読むコストは、走査のコストとそのフィールドが占めるメモリで済みます。

ドキュメントとパスは json-span と同じです。ドキュメントは文字列、 (unsigned-byte 8) のベクタ、または wasm-GC バックエンドでの線形メモリの アドレスとサイズで、パスはキーとインデックスの並びです。2 つの形のあいだで フィルタを移植するときに変えるのは、先頭の引数だけです。

2 番目の値は、gethash の 2 番目の値と同じく、false(nil, t)と存在しない 値(nil, nil)を区別します。

エラー

json-span が受け付けないドキュメントには、そのエラー json-span: ... を通知 します。json-span のページを参照してください。

バックエンドの対応

すべてのバックエンド、すべての WASM モードで動作します。json-span の走査の あと、値のバイト列だけに json-parse を適用します。