JSON을 TOML로 변환

사용 방법

1. 1

   JSON 객체 붙여넣기

   최상위는 객체여야 합니다. TOML 문서는 테이블이므로 루트가 배열이나 스칼라이면 거부됩니다. 샘플 메뉴에서 API 응답, 중첩 배열, 경계 사례를 불러올 수 있습니다.

2. 2

   결과 읽기

   TOML이 바로 표시됩니다. JSON이 잘못됐거나 루트가 객체가 아니면 오류가 대신 나옵니다.

3. 3

   null 알림 확인

   입력에 null이 있으면 몇 개를 뺐는지와 앞쪽 경로가 알림에 나옵니다. 배열의 네 번째 요소는 b[3]처럼 표시됩니다. 대신 넣을 값을 정하거나 없어도 되는지 판단하세요.

4. 4

   배치 확인

   각 테이블에서 단순 값과 인라인 배열이 먼저 오고 그다음 하위 테이블과 테이블 배열이 오므로 JSON과 순서가 다를 수 있습니다.

5. 5

   복사 또는 저장

   TOML을 복사해 설정 파일에 넣습니다.

작동 원리

{"a":null}      -> (빈 문서, 알림: a)
{"a":[1,null]}  -> a = [1] (알림: a[1])
{"a":[1,"b"]}   -> a = [1, "b"]
[1]             -> 오류: 루트는 객체여야 함

실제 예시

{"title":"demo","owner":{"name":"Ada","age":3},"servers":[{"host":"a","port":1},{"host":"b","port":2}],"tags":["x","y"],"ratio":1.5}

title = "demo"
tags = ["x", "y"]
ratio = 1.5

[owner]
name = "Ada"
age = 3

[[servers]]
host = "a"
port = 1

[[servers]]
host = "b"
port = 2

{"name":"x","note":null,"ids":[1,null,2]}

name = "x"
ids = [1, 2]

{"mixed":[1,"two",true,{"k":3}],"servers":[{"host":"a","ports":{"http":80}},{"host":"b"}]}

mixed = [1, "two", true, { k = 3 }]

[[servers]]
host = "a"

[servers.ports]
http = 80

[[servers]]
host = "b"

{"a":{"b":{"c":1}},"matrix":[[1,2],[3]],"script":"line1\nline2","empty":{},"list":[]}

matrix = [[1, 2], [3]]
script = "line1\nline2"
list = []

[a]

[a.b]
c = 1

[empty]

{"a b":1,"x.y":2,"count":1.0,"big":9007199254740993}

"a b" = 1
"x.y" = 2
count = 1.0
big = 9007199254740992

자주 하는 실수

• null인 키는 없는 키가 됩니다

  "proxy": null이 든 설정은 그 키를 잃습니다. 알림이 알려 주지만, 없는 키와 명시된 값을 다르게 다루는 프로그램에는 변환 전에 빈 문자열 같은 대체 값을 직접 넣어야 합니다.

• 배열 안의 null은 위치를 밀어 올립니다

  [1, null, 2]는 [1, 2]가 되어 인덱스 2였던 항목이 1번이 됩니다. 위치가 중요하면 변환 전에 null을 표지 값으로 바꾸세요.

• 정수 값인 실수도 타입을 유지합니다

  파서가 JSON 숫자에 소수점이나 지수가 있었는지 추적합니다. 1.0은 1.0, 1e3은 1000.0으로 써서 TOML 소비자가 실수로 읽게 합니다.

• 큰 정수는 반올림됩니다

  파싱한 숫자 토큰을 JavaScript 숫자로 바꿀 때 2^53을 넘는 값이 반올림되어 9007199254740993은 9007199254740992로 나옵니다. 이런 ID는 문자열로 두세요.

• 키 순서가 바뀝니다

  단순 값이 테이블보다 먼저 묶이므로 JSON에서 마지막이던 키가 TOML에서는 맨 앞에 올 수 있습니다.

• 날짜 문자열은 문자열로 남습니다

  "2024-01-01T00:00:00Z"는 TOML 날짜시간이 아니라 따옴표 문자열로 쓰입니다. 소비자가 날짜시간을 기대하면 따옴표를 직접 지우세요.

자주 묻는 질문