モジュール json は、JSON 関連の関数の Starlark モジュールです。
メンバー
decode
unknown json.decode(x, default=unbound)
"null"
、"true"
、"false"
はNone
、True
、False
として解析されます。- 数値は int として解析されます。小数または指数が含まれている場合は float として解析されます。JSON には非有限値の構文はありませんが、非常に大きな値は無限大としてデコードされることがあります。
- JSON オブジェクトは、新しいフリーズされていない Starlark 辞書として解析されます。同じキー文字列がオブジェクト内に複数回出現した場合、キーの最後の値が保持されます。
- JSON 配列は、新しいフリーズされていない Starlark リストとして解析されます。
x
が有効な JSON エンコードではなく、オプションの default
パラメータが指定されている場合(None
として指定されている場合を含む)、この関数は default
値を返します。x
が有効な JSON エンコードではなく、オプションの default
パラメータが指定されていない場合、この関数は失敗します。
パラメータ
パラメータ | 説明 |
---|---|
x
|
string;
必須 デコードする JSON 文字列。 |
default
|
デフォルトは unbound 指定した場合、 x をデコードできない場合に返す値。 |
encode
string json.encode(x)
encode 関数は、1 つの必須の位置引数を受け取り、ケースごとに JSON に変換します。
- None、True、False はそれぞれ null、true、false に変換されます。
- int は、どんなに大きな値でも 10 進整数としてエンコードされます。一部のデコーダでは、非常に大きな整数をデコードできない場合があります。
- 浮動小数点数の数値が整数であっても、浮動小数点数は小数点または指数、あるいはその両方を使用してエンコードされます。非有限の浮動小数点値をエンコードするとエラーになります。
- 文字列値は、値を表す JSON 文字列リテラルとしてエンコードされます。ペアになっていないサロゲートは U+FFFD に置き換えられます。
- 辞書は、辞書順のキー順で JSON オブジェクトとしてエンコードされます。キーが文字列でない場合はエラーになります。
- リストまたはタプルは JSON 配列としてエンコードされます。
- 構造体のような値は、フィールド名の順序で JSON オブジェクトとしてエンコードされます。
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 |
encode_indent
string json.encode_indent(x, *, prefix='', indent='\t')
json.indent(json.encode(x), ...)
と同等です。フォーマット パラメータの説明については、indent
をご覧ください。
パラメータ
パラメータ | 説明 |
---|---|
x
|
必須 |
prefix
|
文字列。デフォルトは '' です。 |
indent
|
文字列。デフォルトは '\t' です。 |
インデント
string json.indent(s, *, prefix='', indent='\t')
パラメータ
パラメータ | 説明 |
---|---|
s
|
string;
必須 |
prefix
|
文字列。デフォルトは '' です。 |
indent
|
文字列。デフォルトは '\t' です。 |