Комментарии и строки прозы
Вы узнаете
Где может стоять каждый вид заметки и какая строка ломает парсер.
Строка, которая начинается с точки с запятой, — это проза: компилятор пропускает её до конца. Строки прозы стоят на верхнем уровне, между объявлениями. Две косые черты начинают комментарий где угодно: после кода или внутри теста. Ловушка: точка с запятой одна на строке — это не пустая строка прозы, а ошибка разбора, и падает вся спека. Поставьте после неё слово или оставьте строку пустой.
Попробуйте
Добавьте в спеку урока в плеере строку с одной точкой с запятой, прочитайте ошибку и уберите её.
Prose lines, slash comments and the lone semicolon that breaks a t27 spec, each checked with the real compiler. Lesson 3 of the t27 basics course.
specs/basics/03_comments_and_prose.t27
// SPDX-License-Identifier: Apache-2.0
; t27 basics, lesson 3: Comments and prose lines.
; Two kinds of notes: a semicolon line of prose, and a comment after two slashes.
module basics_03_comments_and_prose;
; A prose line starts with a semicolon and must carry words.
// Two slashes start a comment anywhere, also after code.
pub const PROSE_NEEDS_WORDS : bool = true; // a trailing comment
test comments_change_nothing {
// a comment inside a test
assert PROSE_NEEDS_WORDS == true;
}
Все уроки
Модуль 1 · Файл спеки
Что лежит в файле .t27: строка module, строки прозы и комментарии.
Модуль 2 · Значения и типы
Константы, ширина целого числа, а также true, false и текст.
Модуль 3 · Массивы, триты и выражения
Списки значений, три значения трита и что вычисляют операторы.
Модуль 4 · Тесты и функции
Блок test, несколько маленьких тестов в одной спеке и функция с типизированными входами.
Модуль 5 · Внутри функции
Имена через let и var, выбор через if и switch и циклы.
Модуль 6 · Видимость и свои типы
Что pub открывает другим модулям, и структуры и перечисления, которые вы объявляете.
Модуль 7 · Модули, правила и gen-ts
Чтение другого модуля, правило, которое выполняется всегда, и спека, превращённая в TypeScript.
Модуль 8 · Компилятор и tri
Бэкенды, которые пишет t27c, стадии, в которых он читает спеку, и команда tri.
Модуль 9 · Ошибки, программа и что дальше
Как читать ошибку компилятора, одна маленькая законченная программа и какой курс пройти дальше.