모듈 json은 JSON 관련 함수의 Starlark 모듈입니다.
회원
디코딩
unknown json.decode(x, default=unbound)decode 함수에는 JSON 문자열이라는 필수 위치 매개변수가 하나 있습니다. 문자열이 나타내는 Starlark 값을 반환합니다. <ph type="x-smartling-placeholder">
- </ph>
"null","true","false"는None,True,False로 파싱됩니다.- 숫자는 정수로 파싱되고, 소수점이나 지수가 포함된 경우 부동 소수점으로 파싱됩니다. JSON에는 무한한 값에 대한 구문이 없지만 매우 큰 값은 무한대로 디코딩될 수 있습니다.
- JSON 객체가 고정되지 않은 새 Starlark dict로 파싱됩니다. 같은 키 문자열이 객체에서 두 번 이상 나오는 경우 키의 마지막 값이 유지됩니다.
- JSON 배열이 고정되지 않은 새 Starlark 목록으로 파싱됩니다.
x이 유효한 JSON 인코딩이 아니고 선택적 default 매개변수가 지정된 경우 (None로 지정된 경우 포함) 이 함수는 default 값을 반환합니다.
x가 유효한 JSON 인코딩이 아니고 선택적 default 매개변수가 지정되지 않은 경우, 이 함수는 실패합니다.
매개변수
| 매개변수 | 설명 |
|---|---|
x
|
필수 디코딩할 JSON 문자열입니다. |
default
|
기본값은 unbound입니다. 지정하면 x를 디코딩할 수 없을 때 반환되는 값입니다.
|
encode
string json.encode(x)
인코딩 함수는 필수 위치 인수 1개를 허용하며, 각 인수는 사례별로 JSON으로 변환됩니다.
- None, True, False는 각각 'null', 'true', 'false'로 변환됩니다.
- int는 크기에 관계없이 십진수로 인코딩됩니다. 일부 디코더는 매우 큰 정수를 디코딩하지 못할 수도 있습니다.
- 부동 소수점 수는 숫자 값이 정수인 경우에도 소수점이나 지수 또는 둘 다를 사용하여 인코딩됩니다. 유한하지 않은 부동 소수점 값을 인코딩하면 오류가 발생합니다.
- 문자열 값은 값을 나타내는 JSON 문자열 리터럴로 인코딩됩니다. 페어링되지 않은 각 서로게이트는 U+FFFD로 대체됩니다.
- dict는 JSON 객체로 키 순서에 따라 인코딩됩니다. 문자열이 아닌 키가 있으면 오류입니다.
- 목록 또는 튜플은 JSON 배열로 인코딩됩니다.
- 구조체와 유사한 값은 필드 이름 순서에 따라 JSON 객체로 인코딩됩니다.
매개변수
| 매개변수 | 설명 |
|---|---|
x
|
필수 |
encode_indent
string json.encode_indent(x, *, prefix='', indent='\t')encode_indent 함수는
json.indent(json.encode(x), ...)와 동일합니다. 형식 지정 매개변수에 대한 설명은 indent을 참고하세요.
매개변수
| 매개변수 | 설명 |
|---|---|
x
|
필수 |
prefix
|
기본값은 ''입니다. |
indent
|
기본값은 '\t'입니다. |
indent
string json.indent(s, *, prefix='', indent='\t')들여쓰기 함수는 유효한 JSON 인코딩 문자열의 들여쓰기된 형식을 반환합니다. 각 배열 요소 또는 개체 필드는 새 줄에 나타나며, 중첩 깊이에 따라 접두사 문자열로 시작하고 그 뒤에 들여쓰기 문자열의 사본이 하나 이상 표시됩니다. 이 함수는 필수 위치 매개변수인 JSON 문자열과 그리고 키워드 전용 문자열 매개변수 두 개(접두사 및 들여쓰기) 를 사용합니다. 입력이 유효하지 않으면 함수가 실패하거나 잘못된 출력을 반환할 수 있습니다.
매개변수
| 매개변수 | 설명 |
|---|---|
s
|
필수 |
prefix
|
기본값은 ''입니다. |
indent
|
기본값은 '\t'입니다. |