콘텐츠로 이동
한국어

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"}
Ku
8

파싱한 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 지원이 완전히 독립적인 패키지를 뜻하지는 않습니다.

std.json.