模組 json 是 JSON 相關函式的 Starlark 模組。
成員
解碼
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
|
需要解碼的 JSON 字串。 |
default
|
預設為 unbound 如果指定,則在無法解碼 x 時傳回的值。 |
encode
string json.encode(x)
編碼函式會接受一個必要的關鍵引數,並依情況將其轉換為 JSON:
- None、True 和 False 分別會轉換為「null」、「true」和「false」。
- 無論 int 的大小為何,都會編碼為十進位整數。有些解碼器可能無法解碼非常龐大的整數。
- 浮點值會使用小數點或指數 (或兩者皆使用) 進行編碼,即使其數值為整數也一樣。編碼非有限浮點值會導致錯誤。
- 字串值會編碼為表示該值的 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
|
必填 |
prefix
|
預設值為 '' |
indent
|
預設值為 '\t' |