배열 — 동종 관행, 1.0 에서 유연

~10 min · toml, arrays

Level 0평문

0 XP0/64 lessons0/12 achievements

0/100 XP to next level100 XP to go0% complete

배열이 JSON 같이 보이지만, TOML 편의로

TOML 배열은 [a, b, c] — JSON 과 같은 문법. trailing comma 허용 (JSON 의 no-trailing-comma 규칙보다 나음). 가독성을 위해 멀티라인 가능.

관행상 동종; 1.0 에서 혼합

TOML 0.5 가 배열을 동종 (모든 요소 같은 타입) 요구. TOML 1.0 이 그걸 완화 — 혼합 타입 이제 합법. 대부분 파서가 여전히 동종-관행 경고 또는 문서화, consumer 코드 더 단순해서.

멀티라인 배열

[ ] 안 줄바꿈 허용. 배열 안 주석 작동. 사람 편집 config 에 TOML 이 JSON 이기는 정확한 곳.

원칙: 배열이 3 요소 넘거나 각 요소가 사소하지 않을 때 (긴 경로, 구조화된 값, 주석 든 값) 멀티라인 배열 사용. 세로 레이아웃이 diff 깨끗하게 만들고 리뷰 쉬움.

Code

Inline + 멀티라인 배열·toml

# Inline (짧음, 단순)
colors = ["red", "green", "blue"]

# 멀티라인 (길고 diff 쉬움)
allowed_origins = [
  "https://creativeworksofknowledge.com",
  "https://www.creativeworksofknowledge.com",
  "http://localhost:3000",     # dev 만
  "http://localhost:5173",     # vite dev server
]

Trailing comma — TOML 허용·toml

fruits = [
  "apple",
  "banana",
  "cherry",   # ← trailing comma 괜찮음
]

# JSON 이면 파스 에러.
# YAML flow [a, b, c,] 도 일부 파서에서 파스 에러.
# TOML spec 명시: trailing comma OK.

혼합 타입 (TOML 1.0+)·toml

# TOML 1.0 이 혼합 타입 허용 — variant 리스트에 유용
mixed = [1, "two", 3.0, true]

# 관행: 혼합이 진짜 필요한 거 아니면 동종 유지
# Array of table (다음 lesson) 가 구조화된 요소 케이스 더 잘 처리

External links

TOML 1.0 — Array

Exercise

유지하는 YAML 또는 JSON config 의 긴 배열 찾아. TOML 멀티라인 형태로 변환, 줄당 한 항목 + 각 비정상 entry 설명하는 짧은 주석. diff 봐: 미래의 본인이 PR 에서 이걸 읽으며 즉시 각 entry 가 왜 존재하는지 앎. JSON 이 내게 만드는 사람-가독성 세금.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousNumber, boolean, 날짜 — 네이티브 타입 Next →Table — 섹션, 중첩, inline

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.