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 문법 | 엄격함. 주석, 후행 쉼표, 뒤의 추가 입력, 잘못된 유니코드 거부 |
| 입력 / 출력 | 각각 1,000,000바이트 제한 |
| 깊이 예산 | 루트 깊이는 0. depth > 32 거부. 빈 컨테이너 33단계 허용, 34단계 거부 |
| 정수 | 부호 있는 64비트. 범위 초과는 오류이며 float로 자동 변환하지 않음 |
| 부동소수점 | 유한 binary64. 원래 표기, float 태그, 음의 0을 보존하지 않음 |
| 유니코드 | 중국어, 이모지, 이스케이프, 포함된 NUL |
| 중복 객체 키 | 파싱 시 마지막 값 유지 |
| 키 순서 | 인코딩 시 UTF-8 바이트 순서로 정렬 |
1.0은 1로 인코딩될 수 있습니다. float의 정수 표기가 int64를 넘으면 .0을 덧붙입니다. 1e20은 100000000000000000000.0이 되어 다시 디코딩됩니다. 유한 binary64의 원래 표기, float 태그나 음수 0의 부호는 보존하지 않습니다. 이 수정은 해당 릴리스에 포함됩니다.
복구 가능한 오류는 json 도메인을 사용합니다. 주요 코드는 parse_error, stringify_error, out_of_memory입니다. 파싱 메시지의 byte N은 0부터 시작하는 UTF-8 바이트 오프셋입니다. 최소한의 잘못된 입력 처리기는 오류 및 문제 해결을 참고하세요.
백엔드 지원
“백엔드 지원” 제목의 섹션인터프리터, 기본 패키징 러너, 동기 네이티브 C 백엔드에 JSON 구현이 있습니다. 제한된 네이티브 Task 부분집합과 LLVM은 JSON을 지원하지 않습니다. 기본 러너는 가져온 소스의 원래 위치에 여전히 의존합니다. JSON 지원이 완전히 독립적인 패키지를 뜻하지는 않습니다.