Привязка не может занять имя видимого конструктора
Принято 18 ноября 2026 г. · 6.0.0 · Проверяется · Версия 2
Проблема
Одноимённая функция или переменная способна изменить смысл уже имеющегося обращения к конструктору. При допустимом let UserId = 5 имя UserId обозначало бы переменную в вызове и конструктор в шаблоне. Скрытые имена других модулей резервировать не требуется.
Решение
Вариант без данных пишется как Choice.Empty(). Конфликты с видимыми конструкторами отклоняются в привязках, параметрах, именах функций и шаблонах.
В позиции значения None(1) передаёт лишний аргумент стандартному конструктору. Для None своего перечисления укажите имя перечисления.
Привязка видимого имени конструктора newtype вызывает TPZ5712 при проверке. В позиции типа имя остаётся доступным.
Для импорта с псевдонимом проверяется видимое имя. Объявления разных модулей остаются разными.
Примеры
A qualified nullary constructor keeps its parentheses
check · checking · Проверка · Не выполнялось
example.tpzA qualified nullary constructor keeps its parenthesesОткрыть песочницу →
enum Choice { Empty }
let value: Choice=Choice.Empty()
Ожидаемый выводКод завершения 0
$ topaz check example.tpz --language-version 6.0
Ожидаемый результат
Ожидаемый результат
Проверка принимает программу. Код завершения 0.
Нет вывода ошибок.
Этот пример ещё не выполнялся.
A let binding cannot replace the Some constructor
reject · checking · Проверка · Не выполнялось
example.tpzA let binding cannot replace the Some constructor
Диагностика изменения указывает на конкретную причину
Принято 18 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
let mut исправляет проблему неизменяемой привязки. Для отброшенного временного результата или отделённого метода нужно другое исправление.
Решение
При изменении неизменяемой исходной привязки проверка выдаёт TPZ5003 и указывает на её использование.
Если результат изменяющего вызова на временном значении отброшен, TPZ5027 указывает на вызов.
При отделении изменяющего метода TPZ5028 указывает на обращение к члену. Для одного обращения сначала проверяется отделение, затем неизменяемая привязка, затем отброшенное временное значение.
Контракт обязательного основного местоположения не определён.
Этот пример ещё не выполнялся.
Рассмотренные варианты
Сообщать о всех трёх случаях через TPZ5003. Совет сделать привязку изменяемой не исправил бы проблему временного значения или отделённого метода.
Объединить отделение метода и изменение временного значения в одну новую диагностику. У этих случаев разные причины и исправления, поэтому одна диагностика не указала бы одну причину.
Причина
Диагностика подсказывает нужное исправление, будь то изменяемая привязка, использование результата или лямбда.
Для изменения через необязательный доступ нужна изменяемая исходная привязка
Принято 18 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
Изменение неизменяемой коллекции через необязательный доступ могло завершиться ошибкой, только если значение было. Проверка на пустом значении скрывала проблему.
Решение
Поля, индексы, скобки и ?. прослеживаются до исходной привязки. Результат вызова обрывает этот путь.
Неизменяемая привязка вызывает TPZ5003 при проверке независимо от наличия значения.
Изменяемый захват обновляет общую переменную. Для неизменяемого параметра или переменной цикла создайте изменяемое локальное значение.
Имя локальной функции указывает на одно объявление во всём блоке
Принято 19 ноября 2026 г. · 6.0.0 · В работе
Проблема
У двух одноимённых функций один вызов мог обратиться сначала к внешней функции, а после выполнения внутреннего объявления к внутренней. Если при проверке и выполнении выбирались разные функции, код мог пройти проверку даже с разными типами результата.
Решение
Объявление function скрывает одноимённое внешнее значение во всём блоке. Локальные функции одного блока могут вызывать друг друга независимо от порядка объявлений.
Немедленное чтение до объявления вызывает TPZ3018 при разрешении имён.
При чтении в теле функции, лямбда-выражении или другом отложенном выражении возникает TPZ5002, если объявление к этому моменту ещё не выполнено.
Внешние имена функция разрешает в месте своего определения.
Имена, объявленные через let и const, по-прежнему видны после объявления. Повторное имя значения в одном блоке вызывает TPZ5008 во втором объявлении.
Если допустимое константное выражение, например const G = f, ссылается на функцию, G можно вызвать до объявления f. Обычное чтение до объявления невозможно.
Рассмотренные варианты
Сделать имя функции видимым лишь после объявления. Функция не сможет вызвать объявленную ниже функцию, и взаимная рекурсия перестанет работать.
Инициализировать все локальные функции при входе в блок. Ранние вызовы перенесут ошибки инициализации в тело функции. Для функций модуля и локальных функций будут действовать разные правила.
При выполнении выбирать готовую одноимённую функцию. Из одного места можно будет вызвать функции с разными типами результата. Проверенный тип может разойтись с возвращённым значением.
Причина
При проверке и выполнении каждая ссылка ведёт к одному объявлению. Локальные функции могут вызывать друг друга, а ошибка инициализации указывает на место чтения.
Диагностика раннего чтения зависит от границы вычисления
Принято 19 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
Инициализатор может обратиться к имени, объявленному позднее в модуле. В прежнем примере чтение, которое происходит при выполнении, было обозначено как ошибка проверки.
Решение
Чтение до инициализации в немедленно вычисляемом выражении, например в условии или аргументе match, даёт TPZ3018 при разрешении имён.
Если выполнение достигает такого чтения в ветви, шаблоне, условии ветви, правом операнде короткого замыкания, аргументе опционального вызова, теле цикла или позднем шаге генератора, возникает TPZ5002.
Вложенное выражение наследует внешнюю границу условного вычисления, даже если условие задано литералом.
Примеры
A skipped branch does not read a later binding
run · runtime · Проверка · Не выполнялось
example.tpzA skipped branch does not read a later bindingОткрыть песочницу →
import std.io
let chosen: int=if (false) { after } else { 2 }
let after: int=7
io.writeLine("{chosen}:{after}")
Ожидаемый выводКод завершения 0
2:7
$ topaz run example.tpz --language-version 6.0
Ожидаемый результат
Ожидаемый результат
Выполнение завершается. Код завершения 0.
Нет вывода ошибок.
Ожидаемый стандартный вывод
2:7
Этот пример ещё не выполнялся.
The condition is an immediate initializer read
reject · resolve · Проверка · Не выполнялось
example.tpzThe condition is an immediate initializer read
let chosen: int=if (after) { 1 } else { 2 }
let after: bool=true
Ожидаемый выводНенулевой код завершения
Нет стандартного вывода.
$ topaz check example.tpz --language-version 6.0
Ожидаемый результат
Ожидаемый результат
Этап отклонения resolve. Ненулевой код завершения.
Выражение в шаблоне вычисляется, когда до него доходит сопоставление
Принято 19 ноября 2026 г. · 6.0.0 · В работе
Проблема
В шаблоне (x? .. end()) оператор ? в нижней границе может завершить функцию до вычисления верхней границы. Если считать чтение верхней границы немедленным из-за целого типа значения, корректная программа будет отклонена за порядок объявлений. По той же причине while let проверялся иначе, чем другие условия.
Решение
Выражение, дающее проверяемое значение, наследует порядок вычисления окружающего кода. Это правая часть = в let, if let и while let, значение для match и последовательность для for.
Выражение внутри шаблона выполняется, когда сопоставление до него доходит. Чтение неинициализированного внешнего имени в этот момент вызывает TPZ5002 при выполнении.
Момент чтения определяется структурой исходного кода. Тип и значение литерала на него не влияют.
Имена и типы проверяются и в тех выражениях шаблона, которые могут быть пропущены при выполнении.
Во включении вместе с окружающим выражением вычисляется только первый источник. Последующие источники, фильтры и результирующее выражение вычисляются при итерации.
Рассмотренные варианты
Считать границы диапазона немедленными, если значение имеет целый тип. Досрочный выход из нижней границы или несовпадение внешнего шаблона могут пропустить верхнюю границу. Тогда корректная программа будет отклонена.
Доказывать достижимость границы при проверке типов. От результата доказательства будет зависеть, обнаружится ли ошибка при разрешении имён, проверке типов или выполнении.
Причина
По исходному коду видно, когда чтение приведёт к ошибке. Типы и внутренние преобразования синтаксиса не меняют этап диагностики.
Имя указывает на одно и то же объявление при проверке и выполнении
Принято 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 в зависимости от порядка объявлений отклонялось бы при проверке или откладывалось до выполнения.
Причина
Программа, прошедшая проверку, выполняется с теми объявлениями, которые были проверены. Смысл имени в одном месте не зависит ни от порядка выполнения, ни от порядка обхода объявлений при проверке, ни от совпадения со стандартным именем. Готовность проверяется, когда выполнение действительно доходит до привязки, поэтому порядок вычисления и первый эффект не меняются.
Присваивание и передача коллекций дают независимые значения
Принято 9 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
После присваивания массива другой переменной изменение новой переменной могло затронуть исходный массив. По присваиванию это было трудно заметить.
Решение
Массивы, отображения и множества ведут себя как значения. Присваивание, передача аргумента, возврат и запись в поле дают значения, изменяемые независимо.
Реализация может разделять хранилище до первой записи.
Для ресурсов вроде файловых потоков используются общие дескрипторы. Изменяемый захват по-прежнему разделяет переменную.
Отложенный вызов изменяющего метода записывается лямбдой
Принято 16 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
Если сохранить grid[i].push, а затем изменить i, нужно понять, какая ячейка изменится. При одинаковой записи читающий и изменяющий методы могли бы захватывать разные сущности.
Решение
Попытка отделить изменяющий метод, например let add = xs.push, отклоняется при проверке.
Для отложенного вызова пишите let add = (v) => xs.push(v). Читающие методы по-прежнему можно получить как значения.
Разрешить отделённому методу захватывать переменную или ячейку получателя. Читающий метод захватывал бы значение, а изменяющий переменную. При смене индекса результат мог бы отличаться от лямбды.
Причина
Лямбда показывает, что вычислится и изменится в момент вызова.
Результат изменения временного значения нужно использовать
Принято 16 ноября 2026 г. · 6.0.0 · Проверяется
Проблема
Вызов make().push(2) пишет в возвращённое значение без привязки, в которой можно его сохранить. Если отбросить и результат, задуманное изменение может остаться незаметно потерянным.
Решение
Проверка отклоняет изменяющий вызов без исходной привязки, если результат отбрасывается.
Вызов с использованием результата допустим, как в let last = make().pop().
if-without-else-result-type-mismatch at example.tpz:1:18
Нет стандартного вывода.
Этот пример ещё не выполнялся.
Рассмотренные варианты
Возвращать объединение типа истинной ветви и единичного типа. Проверка присвоила бы тип, отличный от уже возвращаемого единичного значения.
Требовать else в позиции значения, если значение then не unit. Это не согласуется с использованием как оператора и с нынешней генерацией кода, которая всегда даёт unit.
Причина
Истинная ветвь может выполнять действия, а тип результата остаётся одним и тем же.