본문으로 건너뛰기
토파즈문서

문서 검색

명세 6.0

방향키로 결과를 고르고 Enter를 눌러 여세요.

API 이름, 진단 번호, 규칙 또는 프로젝트 주제를 입력하세요.

    다운로드 →

    설계 결정

    어휘와 리터럴

    줄바꿈 형식이 문장 경계를 바꾸지 않습니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    같은 파일도 편집기의 줄바꿈 설정에 따라 LF, CRLF, CR로 저장될 수 있습니다. 줄 끝을 가로 공백처럼 읽으면 문장 경계가 달라집니다.

    결정

    • 소스의 LF, CRLF, 단독 CR은 같은 줄바꿈으로 읽습니다.
    • 블록 주석 안의 물리 개행도 모두 같은 문장 경계로 보존합니다. 이후 이 항목을 대체한 결정 주석은 한 줄씩 씁니다 →

    예제

    CRLF separates completed statements

    example.tpzCRLF separates completed statements플레이그라운드 열기 →
    1. import std.io
    2. let value = 1
    3. -2
    4. io.writeLine("{value}")
    기대 출력종료 코드 0
    1
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 1

    Bare CR separates completed statements

    example.tpzBare CR separates completed statements플레이그라운드 열기 →
    1. import std.io
    2. let value = 1 -2
    3. io.writeLine("{value}")
    기대 출력종료 코드 0
    1
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 1

    Bare CR ends a line comment

    example.tpzBare CR ends a line comment플레이그라운드 열기 →
    1. import std.io
    2. // comment io.writeLine("after")
    3. io.writeLine("tail")
    기대 출력종료 코드 0
    after
    tail
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. after
    2. tail

    검토한 대안

    • 단독 CR을 가로 공백으로 둔다. 파일을 다른 형식으로 저장하면 문장 경계가 바뀔 수 있습니다.

    이유

    같은 문장을 운영체제나 편집기의 파일 형식에 맞춰 다시 적을 필요가 없습니다.

    바뀐 규칙 Horizontal space and newlines →Statement boundaries →

    해결한 미정 항목 Carriage returns and comment-contained line breaks →

    판 이력

    블록 주석처럼 보이는 코드는 연산자 규칙으로 진단합니다

    2026년 11월 16일 채택 · 6.0.0 · 확인 중

    문제

    식 다음 줄에 /*를 쓰면 그곳부터 주석이 시작되는 것처럼 보입니다. 두 연산자를 읽는 문법에서는 오류가 어느 토큰에 있는지 정해야 합니다.

    결정

    • /*는 /와 * 두 토큰입니다. 앞줄에 식이 있으면 /가 그 식을 잇고, 피연산자가 필요한 * 자리에서 구문 분석 단계의 TPZ2001을 냅니다.
    • 앞에 이을 식이 없는 소스 첫머리에서는 / 자리에서 거절합니다.

    예제

    The retired block opener is rejected without a closer

    example.tpzThe retired block opener is rejected without a closer플레이그라운드 열기 →
    1. let value: int = 1
    2. /* unfinished
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    검토한 대안

    • 줄 첫머리의 /를 앞줄과 잇지 않는다. 나눗셈에서 줄을 끊는 위치만으로 프로그램의 뜻이 달라집니다.
    • /*를 따로 알아보고 전용 진단을 낸다. 이미 없앤 주석 철자에 전용 토큰과 규칙을 되돌려 놓게 됩니다.

    이유

    나눗셈의 줄 이음 규칙을 유지하면서 피연산자가 빠진 자리를 가리킵니다.

    바뀐 규칙 Block comment spellings are rejected →Statement boundaries →

    주석은 한 줄씩 씁니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    여러 줄을 설명할 때 줄마다 표시하거나 블록으로 감쌀 수 있었습니다. 블록을 쓰면 안에 또 블록을 둘 수 있는지도 알아야 합니다.

    결정

    • 주석은 //로 시작해 그 줄 끝까지 이어집니다.
    • 블록 주석 /* */은 없습니다.

    예제

    A block comment on one line is rejected

    example.tpzA block comment on one line is rejected플레이그라운드 열기 →
    1. import std.io
    2. let value = 1 /* no line break */ +2
    3. io.writeLine("{value}")
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    Parentheses do not admit block comments

    example.tpzParentheses do not admit block comments플레이그라운드 열기 →
    1. import std.io
    2. let value = (1 /* before after */ +2)
    3. io.writeLine("{value}")
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    검토한 대안

    • 줄 주석과 블록 주석을 모두 유지한다. 같은 여러 줄 설명을 두 방법으로 적어야 하고 블록 중첩 규칙도 필요합니다.
    • 블록 주석만 둔다. 주석을 쓰는 방법이 하나가 되어야 하고, 중첩 같은 별도 규칙도 생깁니다.

    이유

    여러 줄 설명은 //를 줄마다 붙이면 됩니다. 줄 중간의 짧은 설명은 앞 줄로 옮겨도 뜻이 같습니다.

    바뀐 규칙 Block comment spellings are rejected →

    판 이력

    문장은 줄바꿈으로 나누고 값은 명시적으로 버립니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    세미콜론은 문장을 나누는 데 쓰였고, 블록 끝에서는 값까지 바꿀 수 있었습니다. 문장 끝을 정리하다가 반환값이 달라질 수 있었습니다.

    결정

    • 문장을 줄바꿈으로 나눕니다. 세미콜론은 쓰지 않습니다.
    • 식의 값을 버릴 때는 let _ = expression을 씁니다. 닫는 괄호 앞의 개행, 빈 줄, 주석은 블록의 끝값을 바꾸지 않습니다.

    예제

    A semicolon cannot discard a block tail

    example.tpzA semicolon cannot discard a block tail플레이그라운드 열기 →
    1. function value() { 7; }
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    • TPZ2001 →

      expected-statement-separator at example.tpz:1:21

    A semicolon cannot separate program items

    example.tpzA semicolon cannot separate program items플레이그라운드 열기 →
    1. let first = 1; let second = 2
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    • TPZ2001 →

      expected-statement-separator at example.tpz:1:14

    검토한 대안

    • 문장 구분에 세미콜론을 허용한다. 줄바꿈과 세미콜론이라는 두 구분법이 남습니다.
    • 세미콜론으로 블록의 끝값을 버린다. 구분 기호 하나가 블록이 돌려주는 값까지 바꿉니다.

    이유

    줄배치와 값 버리기가 코드에서 따로 읽힙니다.

    바뀐 규칙 Statement boundaries →

    이름은 NFC로 적습니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    같아 보이는 한글 이름도 코드 포인트 배열이 다를 수 있습니다. 이름을 비교할 때 두 철자를 어떻게 다룰지 정해야 합니다.

    결정

    • 식별자는 Unicode 16 NFC 원문으로 적습니다. 시작 뒤에는 Mn, Mc, Me 결합 문자를 허용하고 기본 무시 문자는 제외합니다.
    • 문자열의 스칼라와 UTF-8 데이터는 그대로 둡니다.

    예제

    Use the NFC spelling throughout the source

    example.tpzUse the NFC spelling throughout the source플레이그라운드 열기 →
    1. let café: int = 1
    2. let 가: int = 2
    3. let K: int = 3
    4. let value: int = café + 가 + K
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    Reject decomposed source names

    example.tpzReject decomposed source names플레이그라운드 열기 →
    1. let café = 1
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 lex. 종료 코드가 0이 아닙니다.

    Combining marks continue NFC names

    example.tpzCombining marks continue NFC names플레이그라운드 열기 →
    1. let q́: int = 1
    2. let का: int = q́
    3. let x⃝: int = का
    4. loop 'q́ { break 'q́ }
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    Reject an invisible Hangul filler in a name

    example.tpzReject an invisible Hangul filler in a name플레이그라운드 열기 →
    1. let aㅤ = 1
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 lex. 종료 코드가 0이 아닙니다.

    Preserve composed, decomposed, and invisible string data

    example.tpzPreserve composed, decomposed, and invisible string data플레이그라운드 열기 →
    1. import std.io
    2. let composed = "é"
    3. let decomposed = "é"
    4. let hangul = "가"
    5. let invisible = "a͏‍️"
    6. let inserted = "{decomposed}"
    7. io.writeLine(composed.encodeUtf8().toHex())
    8. io.writeLine(decomposed.encodeUtf8().toHex())
    9. io.writeLine(hangul.encodeUtf8().toHex())
    10. io.writeLine(invisible.encodeUtf8().toHex())
    11. io.writeLine(inserted.encodeUtf8().toHex())
    기대 출력종료 코드 0
    c3a9
    65cc81
    e18480e185a1
    61cd8fe2808defb88f
    65cc81
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. c3a9
    2. 65cc81
    3. e18480e185a1
    4. 61cd8fe2808defb88f
    5. 65cc81

    검토한 대안

    • 입력한 철자를 그대로 식별자로 받는다. 같아 보이는 이름이 서로 다른 이름이 될 수 있습니다.
    • 식별자를 읽을 때 자동으로 정규화한다. 원문에서 정규화가 필요했던 자리를 알기 어렵습니다.

    이유

    화면에 같은 이름이 보이면 같은 철자로 작성할 수 있고, 문자열 데이터의 코드 포인트는 그대로 보존됩니다.

    바뀐 규칙 Canonical source spelling →Identifier characters →Preserved Unicode string data →

    진법 접두사와 16진 숫자는 소문자로 씁니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    같은 16진수에서 접두사나 숫자의 대소문자만 바꿀 수 있었습니다. 문자 모양에 따라 달라지는 값은 없었습니다.

    결정

    • 2진수의 0b와 16진수의 0x는 소문자로 씁니다.
    • 16진 숫자 a부터 f까지도 소문자입니다.

    예제

    Reject uppercase hex prefix

    example.tpzReject uppercase hex prefix플레이그라운드 열기 →
    1. let value = 0Xff
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    • TPZ2001 →

      malformed-numeric-literal at example.tpz:1:13

    Reject uppercase binary prefix

    example.tpzReject uppercase binary prefix플레이그라운드 열기 →
    1. let value = 0B1010
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    • TPZ2001 →

      malformed-numeric-literal at example.tpz:1:13

    Reject uppercase hex digit

    example.tpzReject uppercase hex digit플레이그라운드 열기 →
    1. let value = 0xA
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    • TPZ2001 →

      malformed-numeric-literal at example.tpz:1:13

    Read lowercase radix literals

    example.tpzRead lowercase radix literals플레이그라운드 열기 →
    1. import std.io { writeLine }
    2. writeLine("{0xff}")
    3. writeLine("{0b1010}")
    4. writeLine("{0xabcdef}")
    기대 출력종료 코드 0
    255
    10
    11259375
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 255
    2. 10
    3. 11259375

    검토한 대안

    • 대문자 접두사와 대문자 16진 숫자를 허용한다. 같은 수에 대소문자만 다른 철자가 늘어납니다.

    이유

    숫자의 진법과 값에 집중할 수 있고, 표준 16진 출력과 같은 철자를 씁니다.

    바뀐 규칙 Integer spellings →

    시간 길이는 밀리초로 표시하고 넘침을 알립니다

    2026년 11월 9일 채택 · 6.0.0 · 확인 중

    문제

    시간을 더하거나 음수 배율을 곱하면 표현 가능한 범위를 벗어날 수 있습니다. 표시한 값이 다시 읽히는 철자인지도 중요합니다.

    결정

    • Duration은 더하기, 빼기, 양쪽 순서의 정수 곱, 비교, 표시, toMillis()를 지원합니다. 표시는 1500ms 같은 리터럴이고 숫자에서 만들 때는 1ms * n을 씁니다.
    • 넘침, 음수 결과, 음수 배율, toMillis()의 정수 범위 초과는 실행 단계의 TPZ4004입니다.
    • 6.0에는 Duration의 JSON 변환 능력을 두지 않습니다.

    예제

    Add and subtract Duration values

    example.tpzAdd and subtract Duration values
    1. import std.io { writeLine }
    2. let sum = 1s + 500ms
    3. let difference = 2s - 500ms
    4. writeLine("{sum}")
    5. writeLine("{difference}")
    기대 출력종료 코드 0
    1500ms
    1500ms
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 1500ms
    2. 1500ms

    Multiply a Duration by an int in either order

    example.tpzMultiply a Duration by an int in either order
    1. import std.io { writeLine }
    2. let count = 3
    3. let left = 500ms * count
    4. let right = count * 500ms
    5. let constructed = 1ms * count
    6. writeLine("{left}")
    7. writeLine("{right}")
    8. writeLine("{constructed}")
    기대 출력종료 코드 0
    1500ms
    1500ms
    3ms
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 1500ms
    2. 1500ms
    3. 3ms

    Compare Duration values by milliseconds

    example.tpzCompare Duration values by milliseconds
    1. import std.io { writeLine }
    2. let first = 1s
    3. let same = 1000ms
    4. let later = 2s
    5. writeLine("{Eq.equals(first, same)}")
    6. writeLine("{Order.compare(first, later) < 0}")
    7. writeLine("{first == same}")
    8. writeLine("{first != later}")
    9. writeLine("{first < later}")
    10. writeLine("{first <= same}")
    11. writeLine("{later > first}")
    12. writeLine("{same >= first}")
    기대 출력종료 코드 0
    true
    true
    true
    true
    true
    true
    true
    true
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. true
    2. true
    3. true
    4. true
    5. true
    6. true
    7. true
    8. true

    Display millisecond literals and extract int milliseconds

    example.tpzDisplay millisecond literals and extract int milliseconds
    1. import std.io { writeLine }
    2. let delay = 1500ms
    3. let minute = 1m
    4. let second = 1s
    5. let zero = 0ms
    6. let endpoint = 18446744073709551615ms
    7. let intEndpoint = 9223372036854775807ms
    8. writeLine(Show.show(delay))
    9. writeLine("{delay.toMillis()}")
    10. writeLine("{minute.toMillis()}")
    11. writeLine("{second.toMillis()}")
    12. writeLine("{zero}")
    13. writeLine("{endpoint}")
    14. writeLine("{intEndpoint.toMillis()}")
    기대 출력종료 코드 0
    1500ms
    1500
    60000
    1000
    0ms
    18446744073709551615ms
    9223372036854775807
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 1500ms
    2. 1500
    3. 60000
    4. 1000
    5. 0ms
    6. 18446744073709551615ms
    7. 9223372036854775807

    Reject a Duration subtraction below zero

    example.tpzReject a Duration subtraction below zero
    1. let earlier = 1ms
    2. let later = 2ms
    3. let difference = earlier - later
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 run. 종료 코드가 0이 아닙니다.

    • TPZ4004 →

      duration-negative-difference at example.tpz:3:18

    Reject a millisecond count outside int

    example.tpzReject a millisecond count outside int
    1. let delay = 9223372036854775808ms
    2. let count = delay.toMillis()
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 run. 종료 코드가 0이 아닙니다.

    • TPZ4004 →

      duration-to-millis-overflow at example.tpz:2:13

    검토한 대안

    • 정수를 시간 길이로 바꾸는 별도 함수를 둔다. 같은 길이를 만드는 곱셈과 변환 함수의 역할이 겹칩니다.
    • 단위마다 다른 타입을 둔다. 단위는 이미 밀리초 하나라 같은 단위 조건이 필요 없습니다.
    • 나눗셈을 둔다. 만드는 길이 리터럴과 곱 하나라 연산이 겹치지 않습니다.
    • 큰 단위로 줄인 표시(1s500ms)를 쓴다. 표시 형식이 둘이 되지 않도록 밀리초 하나로 적습니다.

    이유

    계산과 표시에서 한 단위를 쓰고 범위를 벗어난 연산은 진단을 냅니다.

    바뀐 규칙 Duration values and operations →

    해결한 미정 항목 Duration operations beyond timeout admission →

    모든 템플릿 태그는 같은 이스케이프를 씁니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    정규식과 셸 템플릿을 번갈아 쓰면 백슬래시가 어느 단계에서 해석되는지 알아야 합니다. 태그 설명이 실제 입력 규칙과 다르면 옮겨 쓴 문자열이 달라질 수 있습니다.

    결정

    • 모든 템플릿 태그에서 같은 이스케이프 문법을 씁니다.
    • 허용되는 이스케이프는 실제로 받는 목록으로 설명합니다.

    예제

    Unknown escape in a r template

    example.tpzUnknown escape in a r template플레이그라운드 열기 →
    1. let value = r"\d"
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 lex. 종료 코드가 0이 아닙니다.

    Every tag cooks the same single-line escapes

    example.tpzEvery tag cooks the same single-line escapes플레이그라운드 열기 →
    1. import std.io
    2. let pattern = r"\n\r\t\\\"\{\}"
    3. io.writeLine(pattern.parts[0])
    4. let command = sh"\n\r\t\\\"\{\}"
    5. io.writeLine(command.parts[0])
    6. let query = sql"\n\r\t\\\"\{\}"
    7. io.writeLine(query.parts[0])
    기대 출력종료 코드 0
    
    
    	\"{}
    
    
    	\"{}
    
    
    	\"{}
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. \"{}
    2. \"{}
    3. \"{}

    검토한 대안

    • r 태그만 백슬래시를 그대로 두고 구분자 규칙을 따로 둔다. 정규식 태그에만 적용되는 백슬래시와 중괄호 규칙을 다시 배워야 합니다.

    이유

    어느 태그에서나 소스를 읽는 단계의 이스케이프를 같은 방식으로 판단할 수 있습니다.

    바뀐 규칙 String escape values →Tagged-template construction and display →

    해결한 미정 항목 Tagged-template value contract →

    파일의 줄바꿈 형식은 문자열 값을 바꾸지 않습니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    여러 줄 문자열이 든 파일을 다른 줄바꿈 형식으로 다시 저장할 수 있습니다. 파일 형식 때문에 문자열 내용이나 들여쓰기 처리까지 달라지면 뜻밖의 값이 나옵니다.

    결정

    • 문자열 리터럴에 적힌 LF, CRLF, 단독 CR을 모두 같은 개행 하나로 읽습니다.
    • 문자열 데이터에 CR이 필요하면 이스케이프를 씁니다. 여러 줄 문자열의 들여쓰기 처리는 개행 형식과 무관합니다.

    예제

    Physical CR uses the same multiline text and indentation

    example.tpzPhysical CR uses the same multiline text and indentation플레이그라운드 열기 →
    1. import std.io
    2. let value = """ first second """
    3. io.writeLine(value.encodeUtf8().toHex())
    기대 출력종료 코드 0
    66697273740a7365636f6e640a
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 66697273740a7365636f6e640a

    Escaped carriage returns remain character data

    example.tpzEscaped carriage returns remain character data플레이그라운드 열기 →
    1. import std.io
    2. let opening = """\rhead"""
    3. let single = "S\rE"
    4. let multi = """
    5. M\rN
    6. """
    7. io.writeLine(opening.encodeUtf8().toHex())
    8. io.writeLine(single.encodeUtf8().toHex())
    9. io.writeLine(multi.encodeUtf8().toHex())
    기대 출력종료 코드 0
    0d68656164
    530d45
    4d0d4e0a
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 0d68656164
    2. 530d45
    3. 4d0d4e0a

    검토한 대안

    • LF와 CRLF만 같은 개행으로 처리한다. CR 줄 끝을 쓰는 파일에서는 같은 소스가 다른 문자열을 만들 수 있습니다.

    이유

    편집기의 줄바꿈 설정을 바꿔도 문자열 값은 그대로입니다.

    바뀐 규칙 Multiline newline values →Multiline closing indentation →

    경로는 Path.from으로 만듭니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    텍스트에서 경로를 만들 때 태그와 함수의 차이를 알아야 했습니다. 경로 구성만 하려는 코드에 두 가지 표기가 필요할지 정해야 했습니다.

    결정

    p 태그를 없앱니다. 문자열에서 경로를 만들 때 Path.from을 씁니다.

    예제

    Path construction uses Path.from instead of the p tag

    example.tpzPath construction uses Path.from instead of the p tag플레이그라운드 열기 →
    1. let value = p"notes"
    기대 출력0이 아닌 종료 코드
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    Path.from normalizes literal and interpolated text

    example.tpzPath.from normalizes literal and interpolated text플레이그라운드 열기 →
    1. import std.io
    2. import std.path { Path }
    3. function normalized(text: string) -> string {
    4. match (Path.from(text)) {
    5. case Ok(value) => value.toString()
    6. case Err(error) => error
    7. }
    8. }
    9. let directory = "notes"
    10. io.writeLine(normalized("./{directory}//draft/../chapter.tpz"))
    11. io.writeLine(normalized("notes\\draft\\..\\chapter.tpz"))
    12. io.writeLine(normalized("notes/.."))
    13. io.writeLine(normalized("Notes/가.TPZ"))
    기대 출력종료 코드 0
    notes/chapter.tpz
    notes/chapter.tpz
    .
    Notes/가.TPZ
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. notes/chapter.tpz
    2. notes/chapter.tpz
    3. .
    4. Notes/가.TPZ

    검토한 대안

    • p 태그에 새 경로 의미를 부여한다. 경로를 만드는 표기와 의미를 하나 더 배워야 합니다.
    • p 태그를 지금처럼 둔다. 경로를 만드는 방법이 하나여야 합니다.

    이유

    경로를 만드는 호출을 어느 코드에서나 같은 이름으로 찾을 수 있습니다. 조각을 안전하게 잇는 일은 Path.join이, 문자열을 경로로 읽는 일은 Path.from이 맡습니다.

    바뀐 규칙 Registered template tags →Construct a normalized Path with Path.from →

    공백뿐인 소스 줄은 문자열에서 빈 줄이 됩니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    여러 줄 문자열에 들여쓰기만 있는 줄을 넣을 수 있습니다. 화면에서는 빈 줄처럼 보여도 공백이 값에 들어가면 다른 문자열이 됩니다.

    결정

    • 공백과 탭만 있는 소스 줄에서는 들여쓰기를 지우고 개행을 남깁니다.
    • 이스케이프와 보간으로 만든 데이터는 그대로 둡니다.

    예제

    Blank source lines ignore indentation

    example.tpzBlank source lines ignore indentation플레이그라운드 열기 →
    1. import std.io
    2. let indented = """
    3. A
    4. B
    5. """
    6. let unindented = """A
    7. B"""
    8. let tagged = r"""
    9. A
    10. B
    11. """
    12. io.writeLine(indented.encodeUtf8().toHex())
    13. io.writeLine(unindented.encodeUtf8().toHex())
    14. io.writeLine(tagged.parts[0].encodeUtf8().toHex())
    기대 출력종료 코드 0
    410a0a0a420a
    410a0a42
    410a0a420a
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 410a0a0a420a
    2. 410a0a42
    3. 410a0a420a

    Escaped and inserted whitespace remains data

    example.tpzEscaped and inserted whitespace remains data플레이그라운드 열기 →
    1. import std.io
    2. let inserted = " \t"
    3. let value = """
    4. A
    5. \t
    6. {inserted}
    7. B
    8. """
    9. io.writeLine(value.encodeUtf8().toHex())
    기대 출력종료 코드 0
    410a090a20090a420a
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 410a090a20090a420a

    검토한 대안

    • 공백뿐인 줄의 들여쓰기를 문자열 데이터로 둔다. 빈 줄처럼 보이는 소스가 눈에 보이지 않는 공백을 값에 담습니다.

    이유

    빈 줄도 보이는 대로 적을 수 있고, 필요한 공백은 이스케이프나 보간으로 남길 수 있습니다.

    바뀐 규칙 Whitespace and interpolation in multiline strings →

    문자열 보간과 파생 Show는 유한 실수를 지수 없이 적습니다

    2026년 11월 18일 채택 · 6.0.0 · 확인 중

    문제

    실수를 보간하거나 파생 출력으로 볼 때 큰 값은 소수부가 사라질 수 있었습니다. 출력만 보고 정수와 실수를 구분하기 어려웠습니다.

    결정

    • 문자열 보간과 파생 표시에서, 유한 비영값은 같은 binary64로 돌아오는 가장 짧은 가수의 십진수를 고릅니다.
    • 후보가 여럿이면 실제 값에 가장 가까운 것을 고릅니다. 거리도 같으면 마지막 숫자가 짝수인 쪽을 고릅니다.
    • 지수 없이 펼쳐 쓰고 소수점 아래를 한 자리 이상 둡니다.
    • 0.0, -0.0, inf, -inf, NaN은 그대로 씁니다. NaN의 부호와 페이로드는 표시하지 않습니다.

    예제

    Finite floats use positional text with a decimal point

    example.tpzFinite floats use positional text with a decimal point
    1. import std.io { writeLine }
    2. let large = 1000000000000000.0
    3. let larger = 1000000000000000000000.0
    4. let small = 0.0000001
    5. let sum = 0.1 + 0.2
    6. let shortSignificand = 1000000000000000128.0
    7. writeLine("{large}")
    8. writeLine("{larger}")
    9. writeLine("{small}")
    10. writeLine("{sum}")
    11. writeLine("{shortSignificand}")
    기대 출력종료 코드 0
    1000000000000000.0
    1000000000000000000000.0
    0.0000001
    0.30000000000000004
    1000000000000000100.0
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 1000000000000000.0
    2. 1000000000000000000000.0
    3. 0.0000001
    4. 0.30000000000000004
    5. 1000000000000000100.0

    Render the largest finite float and the smallest normal and subnormal

    example.tpzRender the largest finite float and the smallest normal and subnormal
    1. import std.io { writeLine }
    2. let largest = 179769313486231570814527423731704356798070567525844996598917476803157260780028538760589558632766878171540458953514382464234321326889464182768467546703537516986049910576551282076245490090389328944075868508455133942304583236903222948165808559332123348274797826204144723168738177180919299881250404026184124858368.0
    3. let smallestNormal = 0.00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002225073858507201383090232717332404064219215980462331830553327416887204434813918195854283159012511020564067339731035811005152434161553460108856012385377718821130777993532002330479610147442583636071921565046942503734208375250806650616658158948720491179968591639648500635908770118304874799780887753749949451580451605050915399856582470818645113537935804992115981085766051992433352114352390148795699609591288891602992641511063466313393663477586513029371762047325631781485664350872122828637642044846811407613911477062801689853244110024161447421618567166150540154285084716752901903161322778896729707373123334086988983175067838846926092773977972858659654941091369095406136467568702398678315290680984617210924625396728515625
    4. let smallestSubnormal = 0.000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004940656458412465441765687928682213723650598026143247644255856825006755072702087518652998363616359923797965646954457177309266567103559397963987747960107818781263007131903114045278458171678489821036887186360569987307230500063874091535649843873124733972731696151400317153853980741262385655911710266585566867681870395603106249319452715914924553293054565444011274801297099995419319894090804165633245247571478690147267801593552386115501348035264934720193790268107107491703332226844753335720832431936092382893458368060106011506169809753078342277318329247904982524730776375927247874656084778203734469699533647017972677717585125660551199131504891101451037862738167250955837389733598993664809941164205702637090279242767544565229087538682506419718265533447265625
    5. writeLine("{largest}")
    6. writeLine("{smallestNormal}")
    7. writeLine("{smallestSubnormal}")
    기대 출력종료 코드 0
    179769313486231570000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000.0
    0.000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000022250738585072014
    0.000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 179769313486231570000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000.0
    2. 0.000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000022250738585072014
    3. 0.000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005

    Negative underflow retains zero sign while NaN drops its sign

    example.tpzNegative underflow retains zero sign while NaN drops its sign플레이그라운드 열기 →
    1. import std.io { writeLine }
    2. let negativeTiny = -0.0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001
    3. let nan = 0.0 / 0.0
    4. let negativeNan = -nan
    5. writeLine("{0.0}|{-0.0}|{negativeTiny}")
    6. writeLine("{nan}|{negativeNan}")
    7. writeLine("{1.0 / 0.0}|{-1.0 / 0.0}")
    기대 출력종료 코드 0
    0.0|-0.0|-0.0
    NaN|NaN
    inf|-inf
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 0.0|-0.0|-0.0
    2. NaN|NaN
    3. inf|-inf

    Derived Show renders record fields and Set elements with the same float rule

    example.tpzDerived Show renders record fields and Set elements with the same float rule
    1. import std.test { assertContains }
    2. record Reading derives Show {
    3. value: float,
    4. samples: Set<float>,
    5. }
    6. let sample = Reading {
    7. value: 1000000000000000.0,
    8. samples: set { 1000000000000000000000.0, 0.0000001 },
    9. }
    10. let text = Show.show(sample)
    11. assertContains(text, "1000000000000000.0")
    12. assertContains(text, "1000000000000000000000.0")
    13. assertContains(text, "0.0000001")
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    검토한 대안

    • 일정 크기부터 정수값의 .0을 뗀다. 같은 타입인데도 값의 크기에 따라 정수와 구별할 수 없게 됩니다.
    • 큰 값과 작은 값을 지수 표기로 쓴다. 이 표기를 그대로 유한 실수 리터럴로 붙여 넣을 수 없습니다.

    이유

    표시된 유한 실수를 다시 소스에 붙여도 같은 값이 되고 정수와 구별됩니다.

    바뀐 규칙 Decimal float values and text rendering →

    경로를 만드는 이름은 Path.from 하나입니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    경로를 만드는 여러 함수가 같은 정규화를 할 수 있습니다. 이미 정규화된 경로에 정규화를 다시 호출하면 바뀌는 값이 없습니다.

    결정

    • 문자열에서 경로를 만들 때 Path.from을 씁니다.
    • 같은 정규화를 하는 다른 생성자와 항등 동작인 normalize를 없앱니다.

    예제

    Path.from normalizes literal and interpolated text →

    Use an existing Path directly

    example.tpzUse an existing Path directly플레이그라운드 열기 →
    1. import std.path { Path }
    2. function keep(value: Path) -> Path { value }
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    검토한 대안

    • 기존 생성자와 normalize를 유지한다. 같은 입력과 결과를 표현하는 호출이 여러 이름으로 남습니다.

    이유

    경로가 어디에서 만들어지고 정규화되는지 호출 이름만 보고 찾을 수 있습니다.

    바뀐 규칙 Construct a normalized Path with Path.from →