JSON リファレンス
このページには選択した言語の翻訳がありません。同じバージョンの英語ドキュメントを表示しています。
std.json は JSON をエンコード・デコードします。json.encode は入力を読み取り専用で借用し、json.decode は内容を独立所有する KuValue を生成します。どちらも Result を返します。stringify、parse、try_parse は互換名です。
インポートとインターフェース
「インポートとインターフェース」という見出しのセクションimport json from "std.json"| インターフェース | 戻り値 | 意味 |
|---|---|---|
json.stringify(&value:any) |
str! |
読み取り専用で新しいコンパクトな JSON テキストにエンコード |
json.parse(text:str) |
KuValue! |
独立した所有の動的な値へ厳密に解析 |
json.try_parse(text:str) |
KuValue! |
parse の互換エイリアス |
json.encode(&value:any) |
str! |
本版に含まれる stringify の別名 |
json.decode(text:str) |
KuValue! |
本版に含まれる parse の別名 |
! は Result を表します。? でエラーを伝播するか、try/catch で処理します。エンコードは入力を消費せず、変更もしません。
値をエンコードして読む
「値をエンコードして読む」という見出しのセクション完全な基本例です。ほかの使い方は examples/json.ku.
import json from "std.json"
fn main(): null! { value = { name: "Ku", count: 7 } text = json.encode(value)? println(text)
decoded = json.decode(text)? println(decoded["name"]?.as_str()?) println(decoded["count"]?.as_int()? + 1) return ok(null)}オブジェクトのキーは決定的な順序でソートされます。期待される出力:
{"count":7,"name":"Ku"}Ku8解析済みの KuValue を直接整数演算に使うことはできません。まず .as_int()? または .as_str()? で変換してください。型が一致しない場合はエラーを返します。存在しないオブジェクトキーも、自動の既定値ではなくエラーを返します。
データと境界
「データと境界」という見出しのセクション対応する入力は、文字列、真偽値、整数、有限の浮動小数点数、null、入れ子の配列、文字列キーのオブジェクト、表現可能な構造体です。関数、Task、リソースハンドル、Result、列挙型、循環参照はエンコードできません。
| 規則 | 現在の実装 |
|---|---|
| JSON 構文 | 厳密。コメント、末尾のカンマ、余分な末尾入力、不正な Unicode を拒否 |
| 入出力 | それぞれ 1,000,000 バイトまで |
| 深さの予算 | ルートの深さは 0。depth > 32 を拒否。空コンテナー 33 階層は受理し、34 階層は拒否 |
| 整数 | 符号付き 64 ビット。オーバーフローはエラーとなり、浮動小数点数に自動変換しない |
| 浮動小数点数 | 有限の binary64。元の表記、float のタグ、負のゼロは保持しない |
| Unicode | 中国語、絵文字、エスケープ、埋め込まれた NUL |
| 重複するオブジェクトキー | 解析時は最後の値を保持 |
| キーの順序 | エンコード時は UTF-8 バイト順にソート |
1.0 は 1 にエンコードされる場合があります。整数形式の float が int64 を超える場合は .0 を追加し、1e20 は 100000000000000000000.0 となって再デコードできます。有限 binary64 の元の表記、float タグ、負のゼロの符号は保持されません。この修正は本版に含まれます。
回復可能なエラーは json ドメインを使用します。主なコードは parse_error、stringify_error、out_of_memory です。解析メッセージの byte N は 0 始まりの UTF-8 バイトオフセットです。不正入力を処理する最小例はエラーとトラブルシューティングを参照してください。
バックエンド対応
「バックエンド対応」という見出しのセクションインタープリター、既定のパッケージ化ランナー、同期ネイティブ C バックエンドには JSON 実装があります。制限付きネイティブ Task サブセットと LLVM は JSON に対応していません。 既定のランナーでは、インポートしたソースの元の場所への依存が残ります。JSON 対応は、完全に独立したパッケージを意味しません。