Перейти к содержимому
Топаздокументация

Поиск в документации

Спецификация 6.0

Выберите результат стрелками и нажмите Enter, чтобы открыть его.

Введите имя API, номер диагностики, правило или тему проекта.

    Загрузка →

    Проектные решения

    Связывания и типы

    У привязки не более одной аннотации типа

    Принято 7 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Тип можно указать у объявления или у его шаблона. Повторение типа заставляет выяснять, какая аннотация определяет привязку.

    Решение

    Объявление отклоняется, если для одной привязки одновременно указаны аннотация привязки и аннотация шаблона.

    Примеры

    Repeat a let annotation

    example.tpzRepeat a let annotationОткрыть песочницу →
    1. let answer: int: int = 1
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения parse. Ненулевой код завершения.

    • TPZ2001 →

      bindings-duplicate-type-annotation at example.tpz:1:16

    Repeat an exported let annotation

    example.tpzRepeat an exported let annotationОткрыть песочницу →
    1. export let answer: int: int = 1
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения parse. Ненулевой код завершения.

    • TPZ2001 →

      bindings-duplicate-type-annotation at example.tpz:1:23

    Repeat a mutable binding annotation

    example.tpzRepeat a mutable binding annotationОткрыть песочницу →
    1. let mut answer: int: int = 1
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения parse. Ненулевой код завершения.

    • TPZ2001 →

      bindings-duplicate-type-annotation at example.tpz:1:20

    Repeat a constant annotation

    example.tpzRepeat a constant annotationОткрыть песочницу →
    1. const answer: int: int = 1
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения parse. Ненулевой код завершения.

    • TPZ2001 →

      bindings-duplicate-type-annotation at example.tpz:1:18

    Annotate each binding once

    example.tpzAnnotate each binding onceОткрыть песочницу →
    1. let local: int = 1
    2. export let published: int = local
    3. let mut count: int = local
    4. const label: string = "Topaz"
    5. export const publishedLabel: string = label
    Ожидаемый выводКод завершения 0
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Рассмотренные варианты

    • Разрешить обе аннотации вместе. Тип одной привязки можно будет указать в двух местах.

    Причина

    Тип привязки достаточно прочитать в одном месте.

    Изменённые правила Binding declaration forms →

    Привязка не может занять имя видимого конструктора

    Принято 18 ноября 2026 г. · 6.0.0 · Проверяется · Версия 2

    Проблема

    Одноимённая функция или переменная способна изменить смысл уже имеющегося обращения к конструктору. При допустимом let UserId = 5 имя UserId обозначало бы переменную в вызове и конструктор в шаблоне. Скрытые имена других модулей резервировать не требуется.

    Решение

    • Вариант без данных пишется как Choice.Empty(). Конфликты с видимыми конструкторами отклоняются в привязках, параметрах, именах функций и шаблонах.
    • В позиции значения None(1) передаёт лишний аргумент стандартному конструктору. Для None своего перечисления укажите имя перечисления.
    • Привязка видимого имени конструктора newtype вызывает TPZ5712 при проверке. В позиции типа имя остаётся доступным.
    • Для импорта с псевдонимом проверяется видимое имя. Объявления разных модулей остаются разными.

    Примеры

    A qualified nullary constructor keeps its parentheses

    example.tpzA qualified nullary constructor keeps its parenthesesОткрыть песочницу →
    1. enum Choice { Empty }
    2. let value: Choice = Choice.Empty()
    Ожидаемый выводКод завершения 0
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    A let binding cannot replace the Some constructor

    example.tpzA let binding cannot replace the Some constructor
    1. let Some = 1
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5712 →

      pattern-constructor-binding-collision at example.tpz:1:5

    A function cannot replace a visible enum variant

    example.tpzA function cannot replace a visible enum variant
    1. enum Choice { Empty }
    2. function Empty() -> int { 1 }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5712 →

      pattern-constructor-binding-collision at example.tpz:2:10

    A qualified enum None uses its declared payload

    example.tpzA qualified enum None uses its declared payload
    1. import std.io { writeLine }
    2. enum Reply { None(int) }
    3. let reply = Reply.None(7)
    4. writeLine(match (reply) { case None(value) => "{value}" })
    Ожидаемый выводКод завершения 0
    7
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 7

    The prelude None does not accept a payload

    example.tpzThe prelude None does not accept a payload
    1. let value: Option<int> = None(1)
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    Контракт обязательного основного местоположения не определён.

    A let binding cannot replace a newtype constructor

    example.tpzA let binding cannot replace a newtype constructor
    1. newtype UserId = int
    2. let UserId = 5
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5712 →

      pattern-constructor-binding-collision at example.tpz:2:5

    A function cannot replace a newtype constructor

    example.tpzA function cannot replace a newtype constructor
    1. newtype UserId = int
    2. function UserId() -> int { 1 }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5712 →

      pattern-constructor-binding-collision at example.tpz:2:10

    The imported alias is a visible newtype constructor

    example.tpzThe imported alias is a visible newtype constructor
    1. import ids { UserId as Id }
    2. let Id = 5
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    ids.tpzThe imported alias is a visible newtype constructor
    1. export newtype UserId = int
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5712 →

      pattern-constructor-binding-collision at example.tpz:2:5

    A newtype alias does not reserve the original unimported spelling

    example.tpzA newtype alias does not reserve the original unimported spelling
    1. import ids { UserId as Id }
    2. let UserId = 5
    3. let user: Id = Id(7)
    Ожидаемый выводКод завершения 0
    $ topaz check example.tpz --language-version 6.0
    ids.tpzA newtype alias does not reserve the original unimported spelling
    1. export newtype UserId = int
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Separate modules may declare the same newtype name

    example.tpzSeparate modules may declare the same newtype name
    1. import first { UserId as FirstId }
    2. import second { UserId as SecondId }
    3. let left: FirstId = FirstId(1)
    4. let right: SecondId = SecondId(2)
    5. let UserId = 3
    Ожидаемый выводКод завершения 0
    $ topaz check example.tpz --language-version 6.0
    first.tpzSeparate modules may declare the same newtype name
    1. export newtype UserId = int
    second.tpzSeparate modules may declare the same newtype name
    1. export newtype UserId = int
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Рассмотренные варианты

    • Проверять конфликты только у привязок в шаблонах. Функция или переменная всё ещё могла бы скрыть конструктор.
    • Считать имя newtype только именем типа и разрешить конфликтующую привязку. У одной записи будут разные роли в вызовах и шаблонах.

    Причина

    Роль конструктора одинакова во всех позициях привязки, а ограничение касается только действительно видимых имён.

    Изменённые правила Reserved None binding name →Variant names and prelude constructors →Newtype constructor argument type →Constructor syntax and binding names →

    История версий
    • Версия 1 · Принято 17 ноября 2026 г. · Привязка не может перекрыть имя видимого конструктора

      Конфликты с видимыми конструкторами отклоняются во всех привязках.

    Диагностика изменения указывает на конкретную причину

    Принято 18 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    let mut исправляет проблему неизменяемой привязки. Для отброшенного временного результата или отделённого метода нужно другое исправление.

    Решение

    • При изменении неизменяемой исходной привязки проверка выдаёт TPZ5003 и указывает на её использование.
    • Если результат изменяющего вызова на временном значении отброшен, TPZ5027 указывает на вызов.
    • При отделении изменяющего метода TPZ5028 указывает на обращение к члену. Для одного обращения сначала проверяется отделение, затем неизменяемая привязка, затем отброшенное временное значение.

    Примеры

    Immutable Option root, present

    example.tpzImmutable Option root, present
    1. let xs: Option<Array<int>> = Some([1])
    2. xs?.push(2)
    Ожидаемый выводНенулевой код завершения
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    Контракт обязательного основного местоположения не определён.

    Statement result discarded

    example.tpzStatement result discarded
    1. function make() -> Array<int> { [1, 2] }
    2. make().pop()
    Ожидаемый выводНенулевой код завершения
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    Контракт обязательного основного местоположения не определён.

    Detached mutator wins over immutable root

    example.tpzDetached mutator wins over immutable root
    1. let xs = [1]
    2. let f = xs.push
    Ожидаемый выводНенулевой код завершения
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    Контракт обязательного основного местоположения не определён.

    Рассмотренные варианты

    • Сообщать о всех трёх случаях через TPZ5003. Совет сделать привязку изменяемой не исправил бы проблему временного значения или отделённого метода.
    • Объединить отделение метода и изменение временного значения в одну новую диагностику. У этих случаев разные причины и исправления, поэтому одна диагностика не указала бы одну причину.

    Причина

    Диагностика подсказывает нужное исправление, будь то изменяемая привязка, использование результата или лямбда.

    Изменённые правила Assignment requires a mutable root →Mutation result consumption →

    Для изменения через необязательный доступ нужна изменяемая исходная привязка

    Принято 18 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Изменение неизменяемой коллекции через необязательный доступ могло завершиться ошибкой, только если значение было. Проверка на пустом значении скрывала проблему.

    Решение

    • Поля, индексы, скобки и ?. прослеживаются до исходной привязки. Результат вызова обрывает этот путь.
    • Неизменяемая привязка вызывает TPZ5003 при проверке независимо от наличия значения.
    • Изменяемый захват обновляет общую переменную. Для неизменяемого параметра или переменной цикла создайте изменяемое локальное значение.

    Примеры

    Immutable Option root, present →

    Immutable Option root, absent

    example.tpzImmutable Option root, absent
    1. let xs: Option<Array<int>> = None()
    2. xs?.push(2)
    Ожидаемый выводНенулевой код завершения
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    Контракт обязательного основного местоположения не определён.

    Optional call through immutable field root

    example.tpzOptional call through immutable field root
    1. record R { items: Option<Array<int>> }
    2. let r = R { items: Some([1]) }
    3. r.items?.push(2)
    Ожидаемый выводНенулевой код завершения
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    Контракт обязательного основного местоположения не определён.

    Mutable optional root can change

    example.tpzMutable optional root can changeОткрыть песочницу →
    1. let mut xs: Option<Array<int>> = Some([1])
    2. xs?.push(2)
    Ожидаемый выводКод завершения 0
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Рассмотренные варианты

    • Пропускать проверку и сообщать об ошибке лишь при наличии значения. Наличие ошибки зависело бы от входных данных.
    • Принимать вызов, только когда значения нет. Результат проверки зависел бы от значения во время выполнения.

    Причина

    Присваивание и вызов изменяющего метода следуют одному правилу изменяемости.

    Изменённые правила Assignment requires a mutable root →

    Имя локальной функции указывает на одно объявление во всём блоке

    Принято 19 ноября 2026 г. · 6.0.0 · В работе

    Проблема

    У двух одноимённых функций один вызов мог обратиться сначала к внешней функции, а после выполнения внутреннего объявления к внутренней. Если при проверке и выполнении выбирались разные функции, код мог пройти проверку даже с разными типами результата.

    Решение

    • Объявление function скрывает одноимённое внешнее значение во всём блоке. Локальные функции одного блока могут вызывать друг друга независимо от порядка объявлений.
    • Немедленное чтение до объявления вызывает TPZ3018 при разрешении имён.
    • При чтении в теле функции, лямбда-выражении или другом отложенном выражении возникает TPZ5002, если объявление к этому моменту ещё не выполнено.
    • Внешние имена функция разрешает в месте своего определения.
    • Имена, объявленные через let и const, по-прежнему видны после объявления. Повторное имя значения в одном блоке вызывает TPZ5008 во втором объявлении.
    • Если допустимое константное выражение, например const G = f, ссылается на функцию, G можно вызвать до объявления f. Обычное чтение до объявления невозможно.

    Рассмотренные варианты

    • Сделать имя функции видимым лишь после объявления. Функция не сможет вызвать объявленную ниже функцию, и взаимная рекурсия перестанет работать.
    • Инициализировать все локальные функции при входе в блок. Ранние вызовы перенесут ошибки инициализации в тело функции. Для функций модуля и локальных функций будут действовать разные правила.
    • При выполнении выбирать готовую одноимённую функцию. Из одного места можно будет вызвать функции с разными типами результата. Проверенный тип может разойтись с возвращённым значением.

    Причина

    При проверке и выполнении каждая ссылка ведёт к одному объявлению. Локальные функции могут вызывать друг друга, а ошибка инициализации указывает на место чтения.

    Изменённые правила Nested block scope →Initialization through branches, calls, and closures →Redeclaration and nested shadowing →

    Диагностика раннего чтения зависит от границы вычисления

    Принято 19 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Инициализатор может обратиться к имени, объявленному позднее в модуле. В прежнем примере чтение, которое происходит при выполнении, было обозначено как ошибка проверки.

    Решение

    • Чтение до инициализации в немедленно вычисляемом выражении, например в условии или аргументе match, даёт TPZ3018 при разрешении имён.
    • Если выполнение достигает такого чтения в ветви, шаблоне, условии ветви, правом операнде короткого замыкания, аргументе опционального вызова, теле цикла или позднем шаге генератора, возникает TPZ5002.
    • Вложенное выражение наследует внешнюю границу условного вычисления, даже если условие задано литералом.

    Примеры

    A skipped branch does not read a later binding

    example.tpzA skipped branch does not read a later bindingОткрыть песочницу →
    1. import std.io
    2. let chosen: int = if (false) { after } else { 2 }
    3. let after: int = 7
    4. io.writeLine("{chosen}:{after}")
    Ожидаемый выводКод завершения 0
    2:7
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 2:7

    The condition is an immediate initializer read

    example.tpzThe condition is an immediate initializer read
    1. let chosen: int = if (after) { 1 } else { 2 }
    2. let after: bool = true
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения resolve. Ненулевой код завершения.

    • TPZ3018 →

      module-initializer-not-ready at example.tpz:1:23

    An executed branch faults before a later binding initializes

    example.tpzAn executed branch faults before a later binding initializesОткрыть песочницу →
    1. let chosen: int = if (true) { after } else { 0 }
    2. let after: int = 7
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения run. Ненулевой код завершения.

    • TPZ5002 →

      bindings-runtime-uninitialized-read at example.tpz:1:31

    Рассмотренные варианты

    • Проверять литеральное условие и отклонять чтение заранее. При замене литерала переменной менялась бы фаза диагностики.

    Причина

    По границе вычисления в исходном коде можно определить момент проверки чтения.

    Изменённые правила Initialization through branches, calls, and closures →

    Выражение в шаблоне вычисляется, когда до него доходит сопоставление

    Принято 19 ноября 2026 г. · 6.0.0 · В работе

    Проблема

    В шаблоне (x? .. end()) оператор ? в нижней границе может завершить функцию до вычисления верхней границы. Если считать чтение верхней границы немедленным из-за целого типа значения, корректная программа будет отклонена за порядок объявлений. По той же причине while let проверялся иначе, чем другие условия.

    Решение

    • Выражение, дающее проверяемое значение, наследует порядок вычисления окружающего кода. Это правая часть = в let, if let и while let, значение для match и последовательность для for.
    • Выражение внутри шаблона выполняется, когда сопоставление до него доходит. Чтение неинициализированного внешнего имени в этот момент вызывает TPZ5002 при выполнении.
    • Момент чтения определяется структурой исходного кода. Тип и значение литерала на него не влияют.
    • Имена и типы проверяются и в тех выражениях шаблона, которые могут быть пропущены при выполнении.
    • Во включении вместе с окружающим выражением вычисляется только первый источник. Последующие источники, фильтры и результирующее выражение вычисляются при итерации.

    Рассмотренные варианты

    • Считать границы диапазона немедленными, если значение имеет целый тип. Досрочный выход из нижней границы или несовпадение внешнего шаблона могут пропустить верхнюю границу. Тогда корректная программа будет отклонена.
    • Доказывать достижимость границы при проверке типов. От результата доказательства будет зависеть, обнаружится ли ошибка при разрешении имён, проверке типов или выполнении.

    Причина

    По исходному коду видно, когда чтение приведёт к ошибке. Типы и внутренние преобразования синтаксиса не меняют этап диагностики.

    Изменённые правила Initialization through branches, calls, and closures →Integer range patterns →

    Имя указывает на одно и то же объявление при проверке и выполнении

    Принято 19 ноября 2026 г. · 6.0.0 · В работе

    Проблема

    В теле функции RoundingMode.HalfEven() до инициализации одноимённой привязки let модуля читал стандартный RoundingMode, а после неё саму привязку. Поэтому функция могла пройти проверку и вернуть значение не того типа, который указан в её объявлении. Знает ли проверка тип привязки, объявленной ниже, зависело от порядка обхода объявлений. Присваивание неизменяемой привязке отклонялось при проверке или только при выполнении в зависимости от порядка объявлений.

    Решение

    • У каждого места, где используется имя, есть одна цель для его роли, и проверка с выполнением используют одну и ту же цель. Состояние инициализации во время выполнения её не меняет. Обычное имя значения ищется только среди объявлений значений в лексической области. Позиции с собственным синтаксисом, например вызовы конструкторов и ссылки на типы, используют свой поиск. Голова Name.member сначала выбирает видимую привязку и указывает на одноимённый тип или стандартную статическую операцию, только если такой привязки нет. Одно объявление с теми же аргументами типа остаётся одним типом при любом написании. Если привязка хранит функцию, целью служит сама привязка, а вызываемая функция читается из неё при выполнении.
    • Импортированное имя становится привязкой верхнего уровня текущего модуля. Повторное объявление этого имени на верхнем уровне модуля по-прежнему даёт TPZ3008, а импорт под псевдонимом оставляет исходное имя свободным. Стандартные имена, видимые без импорта, например RoundingMode, Some и Show, находятся в области снаружи верхнего уровня модуля. Одноимённая привязка верхнего уровня скрывает такое имя для всех ссылок на значения в этом модуле. Объявления внутри блока следуют правилам области блока.
    • Из целей исключается только привязка, которая так и не была создана. Так бывает с привязкой, совпавшей с именем конструктора, и тогда имя указывает на внешнее объявление. Объявление с ошибкой в аннотации или инициализаторе остаётся целью и не передаёт имя следующему одноимённому кандидату. Имя, объявленное в одном блоке дважды, даёт один TPZ5008. Каждое чтение и запись этого имени проверяются по всем видимым кандидатам, и добавляются только ошибки, общие для всех кандидатов. Эти правила определяют последующую диагностику в программах, где ошибки уже есть.
    • Готовность проверяется у выбранной привязки, когда выполнение впервые читает или записывает её. Если код, выполняемый сразу на верхнем уровне модуля, читает или записывает неинициализированную привязку, при разрешении имён возникает TPZ3018. Отложенное чтение до инициализации в теле функции или ветви даёт TPZ5002 при выполнении. Присваивание проверяется на том шаге порядка вычисления, где привязка затрагивается впервые. Поэтому x = value() и r.a = value() сначала вычисляют правую часть, а xs[0] = value() и x += value() сначала читают цель. Если разрешение имён не отклонило код раньше, изменение неизменяемой привязки присваиванием или изменяющим методом даёт TPZ5003 при проверке. Порядок объявлений и то, выполняется ли код, на это не влияют.
    • Тип цели определяется её объявлением, даже если проверка ещё не дошла до этого объявления. Сначала используются аннотации и сигнатуры функций, остальное выводится из инициализаторов и тел функций в порядке зависимостей. Если тип не может быть конечным, например должен содержать сам себя, это противоречие, и в вызвавшем его выражении возникает TPZ5001. Цикл, для которого не хватает сведений, даёт один TPZ5020 или TPZ5022 на каждую группу взаимозависимых объявлений. Откладываются только выводы, которым нужен неизвестный тип, а вопросы, на которые отвечает объявление, проверяются дальше.
    • Привязку, скрывающую стандартное имя, можно переименовать вместе со ссылками на неё в незанятое имя. Каждая ссылка при этом сохраняет целевое объявление, статический тип и признак немедленного или отложенного чтения. Роли, заданные извне, например точка входа main или открытое имя экспорта, должны остаться прежними. Функция при выводе показывает своё имя, например <function Show>, поэтому программа, выбирающая путь выполнения по этой строке, после переименования может вести себя иначе.

    Рассмотренные варианты

    • Выбирать цель по состоянию инициализации во время выполнения. Одно место может видеть объявления разных типов, и функция, прошедшая проверку, может вернуть значение другого типа.
    • Позволить проверке и выполнению выбирать цель независимо. Проверенное и выполненное объявления могут различаться, и результат проверки перестаёт описывать реальный запуск.
    • Скрывать стандартное имя привязкой модуля только после её объявления. Тело функции модуля и так ссылается на привязки модуля, объявленные ниже. Чтобы это правило действовало и при совпадении со стандартным именем, привязка должна скрывать его во всём модуле. Скрытие с места объявления остаётся правилом области блока и действует в блоках.
    • Отклонять с TPZ5020 чтение цели, тип которой проверка ещё не знает. Принятие программы зависело бы от порядка, в котором проверка обходит объявления.
    • Пропускать объявление с ошибкой и брать следующего одноимённого кандидата. Одна ошибка в аннотации незаметно переводит имя на стандартное объявление и порождает сбивающую с толку диагностику.
    • Откладывать все выводы, зависящие от константного выражения, которое читает let модуля. Отсутствие значения остановит и проверки, на которые уже отвечает известный тип.
    • Во всех присваиваниях проверять готовность привязки до правой части. Присваивания вроде x = value() сначала вычисляют правую часть. Ранняя проверка изменила бы этот порядок, и вывод и первая ошибка правой части пропали бы.
    • Проверять право записи во время выполнения. Присваивание одной и той же неизменяемой привязке let в зависимости от порядка объявлений отклонялось бы при проверке или откладывалось до выполнения.

    Причина

    Программа, прошедшая проверку, выполняется с теми объявлениями, которые были проверены. Смысл имени в одном месте не зависит ни от порядка выполнения, ни от порядка обхода объявлений при проверке, ни от совпадения со стандартным именем. Готовность проверяется, когда выполнение действительно доходит до привязки, поэтому порядок вычисления и первый эффект не меняются.

    Изменённые правила Initialization through branches, calls, and closures →Operand and assignment evaluation order →

    Скобки вокруг вызываемого значения сохраняют допустимость в константе

    Принято 7 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Скобки, добавленные для читаемости, могли изменить допустимость вызова в константном выражении. При этом вызываемое значение оставалось тем же.

    Решение

    Допустимость вызова в инициализаторе const не меняется из-за скобок вокруг вызываемого значения.

    Примеры

    Group admitted numeric callees

    example.tpzGroup admitted numeric callees
    1. const bits: int = ((5).and)(3)
    2. const rounded: int = ((2.2).ceil)()
    Ожидаемый выводКод завершения 0
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Group admitted length callees

    example.tpzGroup admitted length callees
    1. import std.typeset
    2. const physical: Length<Pt> = ((1in).toPt)()
    3. const relative: Length<Pt> = ((2em).resolve)(12pt)
    Ожидаемый выводКод завершения 0
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    An ordinary call remains a runtime computation

    example.tpzAn ordinary call remains a runtime computationОткрыть песочницу →
    1. function answer() -> int { 3 }
    2. const direct: int = answer()
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5001 →

      bindings-const-ordinary-call at example.tpz:2:21

    Grouping does not make an ordinary call constant

    example.tpzGrouping does not make an ordinary call constantОткрыть песочницу →
    1. function answer() -> int { 3 }
    2. const grouped: int = (answer)()
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5001 →

      bindings-const-ordinary-call at example.tpz:2:22

    Рассмотренные варианты

    • Учитывать скобки при проверке допустимости. Перегруппировка того же вызова могла бы изменить результат проверки.

    Причина

    Ограничения константного выражения определяются самим вызываемым значением.

    Изменённые правила Constant expressions and retained values →

    Присваивание и передача коллекций дают независимые значения

    Принято 9 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    После присваивания массива другой переменной изменение новой переменной могло затронуть исходный массив. По присваиванию это было трудно заметить.

    Решение

    • Массивы, отображения и множества ведут себя как значения. Присваивание, передача аргумента, возврат и запись в поле дают значения, изменяемые независимо.
    • Реализация может разделять хранилище до первой записи.
    • Для ресурсов вроде файловых потоков используются общие дескрипторы. Изменяемый захват по-прежнему разделяет переменную.

    Примеры

    Assignment keeps array values independent

    example.tpzAssignment keeps array values independentОткрыть песочницу →
    1. import std.io
    2. let a = [1, 2]
    3. let mut b = a
    4. b.push(3)
    5. io.writeLine("{a.length}:{b.length}")
    Ожидаемый выводКод завершения 0
    2:3
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 2:3

    Return a changed local value from a function

    example.tpzReturn a changed local value from a functionОткрыть песочницу →
    1. import std.io
    2. function appended(values: Array<int>) -> Array<int> {
    3. let mut local = values
    4. local.push(3)
    5. local
    6. }
    7. let items = [1, 2]
    8. let changed = appended(items)
    9. io.writeLine("{items.length}:{changed.length}")
    Ожидаемый выводКод завершения 0
    2:3
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 2:3

    A saved record keeps its collection field

    example.tpzA saved record keeps its collection fieldОткрыть песочницу →
    1. import std.io
    2. let mut r = { items: [1, 2] }
    3. let saved = r
    4. r.items[0] = 5
    5. io.writeLine("{saved.items[0]}:{r.items[0]}")
    Ожидаемый выводКод завершения 0
    1:5
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 1:5

    Insert and remove entries in an independent Map value

    example.tpzInsert and remove entries in an independent Map valueОткрыть песочницу →
    1. import std.io
    2. let entries = map { "one": 1 }
    3. let mut changed = entries
    4. changed.insert("two", 2)
    5. io.writeLine("{entries.length}:{changed.length}")
    6. changed.remove("one")
    7. io.writeLine("{entries.keys[0]}:{changed.keys[0]}")
    Ожидаемый выводКод завершения 0
    1:2
    one:two
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 1:2
    2. one:two

    Add and remove members in an independent Set value

    example.tpzAdd and remove members in an independent Set valueОткрыть песочницу →
    1. import std.io
    2. let values = set { 1 }
    3. let mut changed = values
    4. changed.add(2)
    5. io.writeLine("{values.length}:{changed.length}")
    6. changed.remove(1)
    7. io.writeLine("{1 in values}:{1 in changed}")
    Ожидаемый выводКод завершения 0
    1:2
    true:false
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 1:2
    2. true:false

    A mutable capture changes one variable and preserves earlier values

    example.tpzA mutable capture changes one variable and preserves earlier valuesОткрыть песочницу →
    1. import std.io
    2. let mut items = [1]
    3. let before = items
    4. let append: () -> () = () => { items.push(2) }
    5. append()
    6. io.writeLine("{items.length}:{before.length}")
    Ожидаемый выводКод завершения 0
    2:1
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. 2:1

    Рассмотренные варианты

    • Разделять изменяемое хранилище при присваивании коллекции. Изменение через второе имя может затронуть код, читающий исходное значение.

    Причина

    У изменения коллекции видна цель, а общий ресурс по-прежнему представлен дескриптором.

    Изменённые правила Collection values →Values observed by existing and escaping closures →

    Отложенный вызов изменяющего метода записывается лямбдой

    Принято 16 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Если сохранить grid[i].push, а затем изменить i, нужно понять, какая ячейка изменится. При одинаковой записи читающий и изменяющий методы могли бы захватывать разные сущности.

    Решение

    • Попытка отделить изменяющий метод, например let add = xs.push, отклоняется при проверке.
    • Для отложенного вызова пишите let add = (v) => xs.push(v). Читающие методы по-прежнему можно получить как значения.

    Примеры

    Detached mutator wins over immutable root →

    Builtin read method may be detached

    example.tpzBuiltin read method may be detachedОткрыть песочницу →
    1. let xs = [1]
    2. let read = xs.get
    Ожидаемый выводКод завершения 0
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Lambda expresses a mutating callback

    example.tpzLambda expresses a mutating callbackОткрыть песочницу →
    1. let mut xs = [1]
    2. let add = (value: int) => xs.push(value)
    3. add(2)
    Ожидаемый выводКод завершения 0
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Рассмотренные варианты

    • Разрешить отделённому методу захватывать переменную или ячейку получателя. Читающий метод захватывал бы значение, а изменяющий переменную. При смене индекса результат мог бы отличаться от лямбды.

    Причина

    Лямбда показывает, что вычислится и изменится в момент вызова.

    Изменённые правила Mutation result consumption →

    Результат изменения временного значения нужно использовать

    Принято 16 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Вызов make().push(2) пишет в возвращённое значение без привязки, в которой можно его сохранить. Если отбросить и результат, задуманное изменение может остаться незаметно потерянным.

    Решение

    • Проверка отклоняет изменяющий вызов без исходной привязки, если результат отбрасывается.
    • Вызов с использованием результата допустим, как в let last = make().pop().

    Примеры

    Statement result discarded →

    Function argument consumes result

    example.tpzFunction argument consumes resultОткрыть песочницу →
    1. function make() -> Array<int> { [1, 2] }
    2. function log(value: Option<int>) -> () {}
    3. log(make().pop())
    Ожидаемый выводКод завершения 0
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    Parentheses propagate discard

    example.tpzParentheses propagate discard
    1. function make() -> Array<int> { [1, 2] }
    2. (make().pop())
    Ожидаемый выводНенулевой код завершения
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    Контракт обязательного основного местоположения не определён.

    Рассмотренные варианты

    • Принимать вызов даже с отброшенным результатом. При переходе к семантике значений изменение могло бы исчезнуть без диагностики.

    Причина

    Можно использовать результат или поместить получателя в изменяемую привязку.

    Изменённые правила Mutation result consumption →

    Условие без else всегда возвращает единичное значение

    Принято 7 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Без else требовалось решить, можно ли использовать значение истинной ветви. Проверка и генерация кода могли по-разному определять его тип.

    Решение

    Выражение if без else возвращает () даже в позиции значения. Результат истинной ветви отбрасывается.

    Примеры

    An omitted else discards values and preserves selected effects

    example.tpzAn omitted else discards values and preserves selected effects
    1. import std.io
    2. let taken = if (true) {
    3. io.writeLine("then")
    4. 7
    5. }
    6. let skipped = if (false) {
    7. io.writeLine("unexpected")
    8. 9
    9. }
    10. io.writeLine("{taken}")
    11. io.writeLine("{skipped}")
    Ожидаемый выводКод завершения 0
    then
    ()
    ()
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. then
    2. ()
    3. ()

    A unit context accepts discarded non-unit branch values

    example.tpzA unit context accepts discarded non-unit branch values
    1. let taken: () = if (true) { 7 }
    2. let skipped: () = if (false) { "discarded" }
    Ожидаемый выводКод завершения 0
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    The inferred result can be assigned to unit

    example.tpzThe inferred result can be assigned to unit
    1. let inferred = if (true) { 7 }
    2. let checked: () = inferred
    Ожидаемый выводКод завершения 0
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Проверка принимает программу. Код завершения 0.

    An omitted else cannot produce an int result

    example.tpzAn omitted else cannot produce an int resultОткрыть песочницу →
    1. let value: int = if (true) { 7 }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5001 →

      if-without-else-result-type-mismatch at example.tpz:1:18

    Рассмотренные варианты

    • Возвращать объединение типа истинной ветви и единичного типа. Проверка присвоила бы тип, отличный от уже возвращаемого единичного значения.
    • Требовать else в позиции значения, если значение then не unit. Это не согласуется с использованием как оператора и с нынешней генерацией кода, которая всегда даёт unit.

    Причина

    Истинная ветвь может выполнять действия, а тип результата остаётся одним и тем же.

    Изменённые правила The unit type of if without else →Choosing an if branch →

    Решённые открытые вопросы Resolved: the unit result of if without else →Resolved: the unit result of if without else →

    Значение по умолчанию для отображения задаётся через get и оператор подстановки

    Принято 7 ноября 2026 г. · 6.0.0 · В работе

    Проблема

    Если поиск не нашёл значение, его можно заменить запасным. Когда запасное выражение вызывает эффект, важен момент вычисления.

    Решение

    • Пишите m.get(k) ?? fallback. Метод getOr удаляется.
    • Если запасное значение нужно вычислить до поиска, сначала свяжите его через let.

    Примеры

    Evaluate a Map fallback when its key is absent

    example.tpzEvaluate a Map fallback when its key is absentОткрыть песочницу →
    1. import std.io
    2. function makeMap() -> Map<string, int> {
    3. io.writeLine("map")
    4. map { "present": 7 }
    5. }
    6. function makeKey(name: string) -> string {
    7. io.writeLine("key")
    8. name
    9. }
    10. function makeDefault() -> int {
    11. io.writeLine("fallback")
    12. 99
    13. }
    14. let present = makeMap().get(makeKey("present")) ?? makeDefault()
    15. io.writeLine("present={present}")
    16. let absent = makeMap().get(makeKey("missing")) ?? makeDefault()
    17. io.writeLine("absent={absent}")
    18. let inner: Option<int> = None()
    19. let nested = map { "present": inner }
    20. let payload: Option<int> = nested.get("present") ?? Some(99)
    21. io.writeLine("inner={payload ?? 77}")
    Ожидаемый выводКод завершения 0
    map
    key
    present=7
    map
    key
    fallback
    absent=99
    inner=77
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. map
    2. key
    3. present=7
    4. map
    5. key
    6. fallback
    7. absent=99
    8. inner=77

    Preserve eager fallback effects with ordered bindings

    example.tpzPreserve eager fallback effects with ordered bindingsОткрыть песочницу →
    1. import std.io
    2. function makeMap() -> Map<string, int> {
    3. io.writeLine("map")
    4. map { "present": 7 }
    5. }
    6. function makeKey(name: string) -> string {
    7. io.writeLine("key")
    8. name
    9. }
    10. function makeDefault() -> int {
    11. io.writeLine("fallback")
    12. 99
    13. }
    14. let receiver = makeMap()
    15. let key = makeKey("present")
    16. let default = makeDefault()
    17. let present = receiver.get(key) ?? default
    18. io.writeLine("present={present}")
    19. let absent = receiver.get("missing") ?? default
    20. io.writeLine("absent={absent}")
    Ожидаемый выводКод завершения 0
    map
    key
    fallback
    present=7
    absent=99
    
    $ topaz run example.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. map
    2. key
    3. fallback
    4. present=7
    5. absent=99

    Рассмотренные варианты

    • Сохранить getOr вместе с оператором. У одной операции поиска с подстановкой останутся две формы.

    Причина

    По коду видно, вычисляется запасное значение заранее или только при необходимости.

    Изменённые правила Map lookup and optional fallback →