From dda1d076deebcfe3bf4802e22e73bf0ba88ea0ae Mon Sep 17 00:00:00 2001 From: Nikolay Gagarinov Date: Mon, 9 Nov 2026 19:16:22 +0500 Subject: [PATCH 1/2] =?UTF-8?q?fix(exercises):=20=D1=83=D1=82=D0=BE=D1=87?= =?UTF-8?q?=D0=BD=D0=B8=D1=82=D1=8C=20=D1=83=D1=81=D0=BB=D0=BE=D0=B2=D0=B8?= =?UTF-8?q?=D1=8F=20=D0=BF=D0=BE=20=D0=BD=D0=B0=D1=85=D0=BE=D0=B4=D0=BA?= =?UTF-8?q?=D0=B0=D0=BC=20=D1=80=D0=B5=D0=B2=D1=8C=D1=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - conditionals: ранний возврат для nil, как обещает название урока - scope: объявить inner до блока do - sequences: элементы false возвращаются как есть - string-library: в code только ASCII, символ равен байту - while-repeat, syntax, logic, errors, modules: формулировки условия Refs: CONTENT-815 Co-Authored-By: Claude Opus 5.5 --- modules/10-basics/20-syntax/ru/EXERCISE.md | 2 +- modules/20-expressions/30-string-library/ru/EXERCISE.md | 2 +- modules/20-expressions/40-logic/ru/EXERCISE.md | 2 +- modules/40-flow/10-conditionals/index.lua | 4 ++++ modules/40-flow/10-conditionals/ru/EXERCISE.md | 2 +- modules/40-flow/10-conditionals/test.lua | 1 + modules/40-flow/20-while-repeat/ru/EXERCISE.md | 2 +- modules/40-flow/40-scope/ru/EXERCISE.md | 2 +- modules/50-tables/10-sequences/ru/EXERCISE.md | 2 +- modules/60-modules/10-modules/ru/EXERCISE.md | 2 +- modules/60-modules/20-errors/ru/EXERCISE.md | 2 +- 11 files changed, 14 insertions(+), 9 deletions(-) diff --git a/modules/10-basics/20-syntax/ru/EXERCISE.md b/modules/10-basics/20-syntax/ru/EXERCISE.md index df98d3b..d9c4d94 100644 --- a/modules/10-basics/20-syntax/ru/EXERCISE.md +++ b/modules/10-basics/20-syntax/ru/EXERCISE.md @@ -1,4 +1,4 @@ -Наберите в редакторе исправленную версию программы из условия. Уберите отладочный вывод и закройте строку. Программа должна вывести только `Ready`. +Наберите в редакторе исправленную версию программы из условия. Уберите или закомментируйте отладочный вывод и закройте строку. Программа должна вывести только `Ready`. ```text print('Debug') diff --git a/modules/20-expressions/30-string-library/ru/EXERCISE.md b/modules/20-expressions/30-string-library/ru/EXERCISE.md index 9d394d1..0b7653e 100644 --- a/modules/20-expressions/30-string-library/ru/EXERCISE.md +++ b/modules/20-expressions/30-string-library/ru/EXERCISE.md @@ -1 +1 @@ -Из переменной `code` извлеките первые три символа через `string.sub`, переведите результат в верхний регистр через `string.upper` и выведите. Затем выведите последние четыре символа исходной строки. +Из переменной `code` извлеките первые три символа через `string.sub`, переведите результат в верхний регистр через `string.upper` и выведите. Затем выведите последние четыре символа исходной строки. В `code` только ASCII, поэтому каждый символ занимает один байт. diff --git a/modules/20-expressions/40-logic/ru/EXERCISE.md b/modules/20-expressions/40-logic/ru/EXERCISE.md index 57f7c11..a98dc5b 100644 --- a/modules/20-expressions/40-logic/ru/EXERCISE.md +++ b/modules/20-expressions/40-logic/ru/EXERCISE.md @@ -1 +1 @@ -Переменная `saved_limit` содержит `0`. Создайте локальную переменную `limit`, выбрав через `or` сохранённое значение или запасное `10`. Выведите `limit`. Затем выведите результат `saved_name or 'Guest'`, где `saved_name` пока равен `nil`. +Переменная `saved_limit` содержит `0`. Создайте локальную переменную `limit`, выбрав через `or` сохранённое значение или значение по умолчанию `10`. Выведите `limit`. Затем выведите результат `saved_name or 'Guest'`, где `saved_name` пока равен `nil`. diff --git a/modules/40-flow/10-conditionals/index.lua b/modules/40-flow/10-conditionals/index.lua index 337d11c..a8ccdb7 100644 --- a/modules/40-flow/10-conditionals/index.lua +++ b/modules/40-flow/10-conditionals/index.lua @@ -1,5 +1,9 @@ local function classify(number) -- BEGIN + if number == nil then + return 'missing' + end + if number < 0 then return 'negative' elseif number == 0 then diff --git a/modules/40-flow/10-conditionals/ru/EXERCISE.md b/modules/40-flow/10-conditionals/ru/EXERCISE.md index bca7396..2aa6ccf 100644 --- a/modules/40-flow/10-conditionals/ru/EXERCISE.md +++ b/modules/40-flow/10-conditionals/ru/EXERCISE.md @@ -1 +1 @@ -Допишите `classify(number)`. Она возвращает `negative` для числа меньше нуля, `zero` для нуля и `positive` для положительного числа. Вывода на экран не требуется. +Допишите `classify(number)`. Если `number` равно `nil`, сразу верните `missing`. Для числа функция возвращает `negative` для числа меньше нуля, `zero` для нуля и `positive` для положительного числа. Вывода на экран не требуется. diff --git a/modules/40-flow/10-conditionals/test.lua b/modules/40-flow/10-conditionals/test.lua index 9eb61df..01bf28d 100644 --- a/modules/40-flow/10-conditionals/test.lua +++ b/modules/40-flow/10-conditionals/test.lua @@ -5,3 +5,4 @@ test.equal('negative', classify(-4)) test.equal('zero', classify(0)) test.equal('positive', classify(7)) test.equal('negative', classify(-0.5)) +test.equal('missing', classify(nil)) diff --git a/modules/40-flow/20-while-repeat/ru/EXERCISE.md b/modules/40-flow/20-while-repeat/ru/EXERCISE.md index 8e76ef5..4f67d98 100644 --- a/modules/40-flow/20-while-repeat/ru/EXERCISE.md +++ b/modules/40-flow/20-while-repeat/ru/EXERCISE.md @@ -1 +1 @@ -Допишите `count_doublings(limit)`. Начните с `value = 1` и удваивайте его, пока оно меньше `limit`. Верните два результата, полученное значение и количество удвоений. Для `limit <= 1` верните `1` и `0`. `limit` является положительным целым числом. +Допишите `count_doublings(limit)`. Начните с `value = 1` и удваивайте его, пока оно меньше `limit`. Верните два результата, полученное значение и количество удвоений. Для `limit`, равного `1`, верните `1` и `0`. `limit` является положительным целым числом. diff --git a/modules/40-flow/40-scope/ru/EXERCISE.md b/modules/40-flow/40-scope/ru/EXERCISE.md index 96ad7f5..cc649ed 100644 --- a/modules/40-flow/40-scope/ru/EXERCISE.md +++ b/modules/40-flow/40-scope/ru/EXERCISE.md @@ -1 +1 @@ -Допишите `scoped_value(start)`. Сохраните `start` в локальной переменной `value`. В блоке `do` создайте другую локальную `value`, равную внешнему значению плюс `5`, и передайте её в локальную переменную `inner`. Верните два значения, `inner` и сохранившееся внешнее `value`. Для входа `10` это `15` и `10`. Глобальных переменных создавать не нужно. +Допишите `scoped_value(start)`. Сохраните `start` в локальной переменной `value`. В блоке `do` создайте другую локальную `value`, равную внешнему значению плюс `5`, и передайте её в локальную переменную `inner`. Объявите `inner` до блока `do`, чтобы значение сохранилось после `end`. Верните два значения, `inner` и сохранившееся внешнее `value`. Для входа `10` это `15` и `10`. Глобальных переменных создавать не нужно. diff --git a/modules/50-tables/10-sequences/ru/EXERCISE.md b/modules/50-tables/10-sequences/ru/EXERCISE.md index acb04b7..1087191 100644 --- a/modules/50-tables/10-sequences/ru/EXERCISE.md +++ b/modules/50-tables/10-sequences/ru/EXERCISE.md @@ -1 +1 @@ -Допишите `list_info(items)`. Она принимает последовательность без пропусков и возвращает три значения, её длину, первый и последний элементы. Для пустой таблицы верните `0`, `nil`, `nil`. Исходную таблицу менять не нужно. +Допишите `list_info(items)`. Она принимает последовательность без пропусков и возвращает три значения, её длину, первый и последний элементы. Для пустой таблицы верните `0`, `nil`, `nil`. Элементы могут быть равны `false`, такие значения возвращайте как есть. Исходную таблицу менять не нужно. diff --git a/modules/60-modules/10-modules/ru/EXERCISE.md b/modules/60-modules/10-modules/ru/EXERCISE.md index 6d98f68..bd407d7 100644 --- a/modules/60-modules/10-modules/ru/EXERCISE.md +++ b/modules/60-modules/10-modules/ru/EXERCISE.md @@ -1 +1 @@ -В каталоге упражнения есть готовый модуль _pricing.lua_. Он возвращает таблицу с функцией `total(price, count)`. Допишите `order_total(price, count, delivery)`. Подключите `pricing` через `require`, вычислите стоимость товаров через `pricing.total` и верните её вместе со стоимостью доставки. Здесь «вместе» означает одну общую сумму. +В каталоге упражнения есть готовый модуль _pricing.lua_. Он возвращает таблицу с функцией `total(price, count)`. Допишите `order_total(price, count, delivery)`. Подключите `pricing` через `require`, вычислите стоимость товаров через `pricing.total` и верните её вместе со стоимостью доставки. Здесь «вместе» означает одну общую сумму. `require` можно вызвать прямо в теле функции, повторный вызов возьмёт модуль из кеша. diff --git a/modules/60-modules/20-errors/ru/EXERCISE.md b/modules/60-modules/20-errors/ru/EXERCISE.md index 877a044..caf02dd 100644 --- a/modules/60-modules/20-errors/ru/EXERCISE.md +++ b/modules/60-modules/20-errors/ru/EXERCISE.md @@ -1 +1 @@ -Допишите `safe_call(operation, value)`. Вызовите `operation(value)` через `pcall`. При успехе верните её единственный результат. При ошибке верните два значения, `nil` и полученную ошибку без изменений. `operation` возвращает один результат или вызывает ошибку. Успешные `false` и `nil` не считаются ошибкой. +Допишите `safe_call(operation, value)`. Вызовите `operation(value)` через `pcall`. При успехе верните её единственный результат. При ошибке верните два значения, `nil` и значение ошибки без изменений. `operation` возвращает один результат или вызывает ошибку. Успешные `false` и `nil` не считаются ошибкой. From e0472c7b58e28ea333702fada6c91547a936b4a4 Mon Sep 17 00:00:00 2001 From: Nikolay Gagarinov Date: Mon, 9 Nov 2026 19:16:22 +0500 Subject: [PATCH 2/2] =?UTF-8?q?fix(lessons):=20=D0=BF=D0=BE=D0=BF=D1=80?= =?UTF-8?q?=D0=B0=D0=B2=D0=B8=D1=82=D1=8C=20=D0=BD=D0=B5=D1=82=D0=BE=D1=87?= =?UTF-8?q?=D0=BD=D0=BE=D1=81=D1=82=D0=B8=20=D0=B8=20=D0=BF=D0=BE=D0=BA?= =?UTF-8?q?=D0=B0=D0=B7=D0=B0=D1=82=D1=8C=20=D0=BF=D1=80=D0=B8=D0=BC=D0=B5?= =?UTF-8?q?=D1=80=D0=B0=D0=BC=D0=B8=20=D1=83=D1=82=D0=B2=D0=B5=D1=80=D0=B6?= =?UTF-8?q?=D0=B4=D0=B5=D0=BD=D0=B8=D1=8F=20=D1=82=D0=B5=D0=BE=D1=80=D0=B8?= =?UTF-8?q?=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - убрать номер версии Lua и отсылки к модулям по их месту в курсе - исправить неточности: обход ipairs с пропуском, вывод type(nil), заглушка анонимной функции, пример repeat, черновик в nested - добавить примеры с выводом для утверждений без демонстрации, вывод проверен на Lua 5.4 в образе курса Refs: CONTENT-815 Co-Authored-By: Claude Opus 5.5 --- modules/10-basics/10-hello-world/ru/README.md | 4 +-- modules/10-basics/20-syntax/ru/README.md | 10 ++++++ modules/10-basics/30-variables/ru/README.md | 10 +++++- modules/10-basics/40-types/ru/README.md | 4 +-- .../20-expressions/10-numbers/ru/README.md | 6 ++-- .../20-expressions/20-strings/ru/README.md | 16 +++++++++ .../30-string-library/ru/README.md | 14 ++++++-- modules/20-expressions/40-logic/ru/README.md | 18 ++++++++-- .../30-functions/10-definition/ru/README.md | 10 ++++-- .../20-multiple-results/ru/README.md | 14 ++++++-- .../30-function-values/ru/README.md | 10 ++++-- modules/30-functions/40-closures/ru/README.md | 10 +++++- modules/40-flow/10-conditionals/ru/README.md | 9 ++++- modules/40-flow/20-while-repeat/ru/README.md | 15 +++++++-- modules/40-flow/30-for/ru/README.md | 22 +++++++++++-- modules/40-flow/40-scope/ru/README.md | 33 ++++++++++++++++++- modules/50-tables/20-records/ru/README.md | 2 +- modules/50-tables/40-ipairs/ru/README.md | 8 ++++- modules/50-tables/50-pairs/ru/README.md | 5 +++ modules/50-tables/60-nested/ru/README.md | 11 +++++-- modules/50-tables/70-varargs/ru/README.md | 8 +++++ modules/60-modules/10-modules/ru/README.md | 2 +- modules/60-modules/20-errors/ru/README.md | 23 +++++++++++++ 23 files changed, 232 insertions(+), 32 deletions(-) diff --git a/modules/10-basics/10-hello-world/ru/README.md b/modules/10-basics/10-hello-world/ru/README.md index 064d8a8..c24c75c 100644 --- a/modules/10-basics/10-hello-world/ru/README.md +++ b/modules/10-basics/10-hello-world/ru/README.md @@ -1,6 +1,6 @@ Этот курс поможет освоить Lua как второй язык программирования. Мы предполагаем, что вы уже пишете функции, условия и циклы и знакомы с коллекциями. Здесь мы сосредоточимся на записи Lua и особенностях её поведения, чтобы вы могли перенести эти навыки в новый язык. -Lua часто встраивают в приложения для написания сценариев. Программа на Lua получает возможности от своего окружения. Например, игровые объекты предоставляет движок. В этом курсе мы работаем с обычным Lua 5.4 и его стандартной библиотекой. API движков и отличия Luau в Roblox остаются за границами курса. +Lua часто встраивают в приложения для написания сценариев. Программа на Lua получает возможности от своего окружения. Например, игровые объекты предоставляет движок. В этом курсе мы работаем с обычным Lua и его стандартной библиотекой. API движков и отличия диалекта Luau, на котором пишут в Roblox, остаются за границами курса. Вызов `print` выводит значение и добавляет перевод строки. @@ -18,4 +18,4 @@ Hello, World! На Code Basics код выполняется в браузерном упражнении. Напишите решение в редакторе и запустите проверку. В заданиях на вывод используйте `print`. Тесты сравнят результат с условием. Устанавливать интерпретатор для этих заданий не нужно. -В следующих уроках разберём несколько возвращаемых значений, замыкания, устройство таблиц и подключение модулей. В каждом задании вы примените изученную возможность Lua. +Дальше в курсе разберём несколько возвращаемых значений, замыкания, устройство таблиц и подключение модулей. В каждом задании вы примените изученную возможность Lua. diff --git a/modules/10-basics/20-syntax/ru/README.md b/modules/10-basics/20-syntax/ru/README.md index 79f3554..d8554a6 100644 --- a/modules/10-basics/20-syntax/ru/README.md +++ b/modules/10-basics/20-syntax/ru/README.md @@ -32,3 +32,13 @@ lua: index.lua:1: unfinished string near ''Ready)' Число после имени файла обозначает строку, где интерпретатор обнаружил проблему. Причина может находиться раньше указанного места. В этом случае перед закрывающей скобкой не хватает кавычки. Исправленная запись выглядит как `print('Ready')`. Lua различает регистр имён. В стандартной библиотеке есть `print`, а `Print` обозначает другое имя. Неверный регистр может привести к ошибке уже при выполнении синтаксически корректной программы. + +```text +Print('Ready') +``` + +Разбор проходит успешно, а при запуске имя `Print` оказывается пустым. + +```text +lua: index.lua:1: attempt to call a nil value (global 'Print') +``` diff --git a/modules/10-basics/30-variables/ru/README.md b/modules/10-basics/30-variables/ru/README.md index f1d89e5..854b45a 100644 --- a/modules/10-basics/30-variables/ru/README.md +++ b/modules/10-basics/30-variables/ru/README.md @@ -8,7 +8,7 @@ print(price) -- 35 Для изменения уже объявленной переменной `local` не повторяют. Оператор `+=` в Lua отсутствует, поэтому обновление записывается целиком. -Присваивание имени без доступного локального объявления записывает значение в глобальное окружение. Такое имя может затронуть другие части программы. В учебных решениях объявляйте переменные через `local`. Область видимости локальных имён мы отдельно разберём на блоках. +Присваивание имени без доступного локального объявления записывает значение в глобальное окружение. Такое имя может затронуть другие части программы. В учебных решениях объявляйте переменные через `local`. Область видимости локальных имён мы отдельно разберём дальше в курсе. Lua позволяет объявить несколько переменных и присвоить несколько значений одной инструкцией. Все выражения справа вычисляются до записи в переменные слева. Это позволяет обменять значения без временной переменной. @@ -21,4 +21,12 @@ print(right) -- 10 Если справа меньше значений, свободные позиции получают `nil`. Это значение обозначает отсутствие данных. Лишние значения справа отбрасываются. +```lua +local first, second = 1 +print(second) -- nil + +local only = 1, 2 +print(only) -- 1 +``` + Имена различают регистр и могут содержать латинские буквы, цифры и подчёркивание. Начинать имя с цифры нельзя. В курсе используем имена вида `total_price` и не занимаем ключевые слова вроде `local` или `end`. diff --git a/modules/10-basics/40-types/ru/README.md b/modules/10-basics/40-types/ru/README.md index 3ad3458..acaa86e 100644 --- a/modules/10-basics/40-types/ru/README.md +++ b/modules/10-basics/40-types/ru/README.md @@ -14,7 +14,7 @@ print(type(value)) -- string ```lua local missing print(missing) -- nil -print(type(missing)) -- nil +print(type(missing)) -- nil, as a string ``` Число и его строковая запись относятся к разным типам. Чтобы явно получить число из строки, вызовите `tonumber`. @@ -25,6 +25,6 @@ print(amount + 2) -- 17 print(tonumber('hello')) -- nil ``` -Некорректная запись числа даёт `nil`. С таким результатом нельзя продолжать арифметику без проверки. Проверять его условием научимся в модуле управления потоком. +Некорректная запись числа даёт `nil`. С таким результатом нельзя продолжать арифметику без проверки. Проверять его условием научимся дальше в курсе. Для обратного преобразования есть `tostring`. Например, `tostring(15)` возвращает `'15'`. Lua умеет выполнять некоторые неявные преобразования, но явный вызов показывает намерение программы и позволяет отдельно обработать неудачу. diff --git a/modules/20-expressions/10-numbers/ru/README.md b/modules/20-expressions/10-numbers/ru/README.md index 3772269..d280b08 100644 --- a/modules/20-expressions/10-numbers/ru/README.md +++ b/modules/20-expressions/10-numbers/ru/README.md @@ -1,6 +1,6 @@ У числовых операций Lua есть несколько особенностей, которые влияют на перенос знакомых формул. В этом уроке мы сравним деление `/` и `//`, найдём остаток и запишем степень. -Функция `math.type` различает подтипы `integer` и `float`. Lua 5.4 поддерживает целые числа и числа с плавающей точкой внутри типа `number`. Оператор `/` всегда выполняет деление с результатом с плавающей точкой. Оператор `//` округляет частное вниз. +Функция `math.type` различает подтипы `integer` и `float`. Lua поддерживает целые числа и числа с плавающей точкой внутри типа `number`. Оператор `/` всегда выполняет деление с результатом с плавающей точкой. Оператор `//` округляет частное вниз. ```lua print(9 / 2) -- 4.5 @@ -11,13 +11,15 @@ print(math.type(9)) -- integer print(math.type(9 / 2)) -- float ``` -Для отрицательного частного округление вниз отличается от отбрасывания дробной части. Остаток `%` согласован с этим правилом. При положительном делителе он неотрицателен. +Для отрицательного частного округление вниз отличается от отбрасывания дробной части. Остаток `%` согласован с этим правилом: `a % b` равен `a - (a // b) * b`. При положительном делителе он неотрицателен. ```lua print(17 % 5) -- 2 print(-3 % 2) -- 1 ``` +Во втором случае `-3 // 2` равно `-2`, поэтому остаток равен `-3 - (-2) * 2`, то есть `1`. + Для возведения в степень используется `^`. Степень имеет более высокий приоритет, чем унарный минус. Поэтому скобки могут изменить результат. ```lua diff --git a/modules/20-expressions/20-strings/ru/README.md b/modules/20-expressions/20-strings/ru/README.md index b93be76..c57f9fa 100644 --- a/modules/20-expressions/20-strings/ru/README.md +++ b/modules/20-expressions/20-strings/ru/README.md @@ -8,6 +8,15 @@ print('First\nSecond') print('C:\\temp') ``` +Второй вызов выводит две строки, третий выводит одну косую черту. + +```text +I'm learning Lua +First +Second +C:\temp +``` + Длинные строки между `[[` и `]]` сохраняют переносы строк и не разбирают такие экранирования. Они удобны для фрагмента текста с несколькими строками. Начальный перенос сразу после `[[` Lua пропускает. ```lua @@ -17,6 +26,13 @@ Second]] print(message) ``` +Перенос внутри скобок попадает в значение, поэтому вывод занимает две строки. + +```text +First +Second +``` + Для конкатенации используется `..`. Оператор не добавляет пробелов и создаёт новое значение. Исходные строки остаются прежними. ```lua diff --git a/modules/20-expressions/30-string-library/ru/README.md b/modules/20-expressions/30-string-library/ru/README.md index cd0f706..98df245 100644 --- a/modules/20-expressions/30-string-library/ru/README.md +++ b/modules/20-expressions/30-string-library/ru/README.md @@ -19,9 +19,19 @@ print(string.sub(code, -4)) -- 2026 print(string.upper(code)) -- LUA-2026 ``` -Тот же вызов строковой функции можно записать через двоеточие, например `code:sub(1, 3)` равнозначен `string.sub(code, 1, 3)`. Двоеточие передаёт значение слева первым аргументом. При записи через точку этот аргумент передаётся явно. +Тот же вызов строковой функции можно записать через двоеточие. Двоеточие передаёт значение слева первым аргументом. При записи через точку этот аргумент передаётся явно. -`string.format('%.2f', 12.5)` возвращает строку `'12.50'`. Формат `%.2f` задаёт два знака после десятичной точки. +```lua +local code = 'lua-2026' +print(code:sub(1, 3)) -- lua +print(string.sub(code, 1, 3)) -- lua +``` + +`string.format` собирает строку по шаблону. Формат `%.2f` задаёт два знака после десятичной точки. + +```lua +print(string.format('%.2f', 12.5)) -- 12.50 +``` `string.upper` возвращает новую строку. Для примера используем ASCII, поскольку стандартная строковая библиотека не выполняет полноценное преобразование регистра Unicode. diff --git a/modules/20-expressions/40-logic/ru/README.md b/modules/20-expressions/40-logic/ru/README.md index 20fa9b5..b5c884d 100644 --- a/modules/20-expressions/40-logic/ru/README.md +++ b/modules/20-expressions/40-logic/ru/README.md @@ -24,6 +24,20 @@ print(false and 'Ready') -- false print('' or 'Guest') -- empty line ``` -Так можно подставить запасное значение вместо `nil`. Но `or` также заменит `false`, поэтому для логической настройки с допустимым `false` нужна явная проверка отсутствия. +Так можно подставить значение по умолчанию вместо `nil`. Но `or` также заменит `false`, поэтому для логической настройки с допустимым `false` нужна явная проверка отсутствия. -В выражении `condition and x or y` значение `x`, равное `false` или `nil`, приведёт к выбору `y`. Когда нужны такие результаты, используйте обычное ветвление из модуля управления потоком. По приоритету `not` выполняется раньше `and`, а `and` раньше `or`. +```lua +local enabled = false +print(enabled or true) -- true +print(enabled == nil) -- false +``` + +Выражение `enabled or true` потеряло заданное `false`, а сравнение с `nil` показывает, что настройка задана. + +В выражении `condition and x or y` значение `x`, равное `false` или `nil`, приведёт к выбору `y`. + +```lua +print(true and false or 'fallback') -- fallback +``` + +Когда нужны такие результаты, используйте обычное ветвление. По приоритету `not` выполняется раньше `and`, а `and` раньше `or`. diff --git a/modules/30-functions/10-definition/ru/README.md b/modules/30-functions/10-definition/ru/README.md index 295c857..e61cc6e 100644 --- a/modules/30-functions/10-definition/ru/README.md +++ b/modules/30-functions/10-definition/ru/README.md @@ -12,8 +12,14 @@ print(rectangle_area(3, 4)) -- 12 Слово `local` ограничивает доступность имени функции текущим блоком. Форма `local function` также позволяет обращаться к этой функции из её собственного тела, что нужно для рекурсии. -Количество аргументов Lua не сверяет с количеством параметров. Недостающие параметры получают `nil`, а лишние аргументы обычной функции отбрасываются. Например, `rectangle_area(3)` приведёт к ошибке умножения числа на `nil`. Если параметр необязателен, значение по умолчанию нужно обработать в теле самостоятельно. +Количество аргументов Lua не сверяет с количеством параметров. Недостающие параметры получают `nil`, а лишние аргументы обычной функции отбрасываются. Например, `rectangle_area(3)` приведёт к ошибке умножения числа на `nil`. + +```text +lua: index.lua:2: attempt to perform arithmetic on a nil value (local 'height') +``` + +Если параметр необязателен, значение по умолчанию нужно обработать в теле самостоятельно. Файл Lua выполняется как отдельный блок кода и тоже может вернуть результат. В заготовках упражнений после объявления функции стоит готовая строка возврата самой функции, например `return total_price`. Она передаёт тестам саму функцию, чтобы её можно было вызвать с разными аргументами. Круглых скобок в этой строке нет, поэтому вызов здесь не происходит. -В заданиях дописывайте тело указанной функции. Готовую строку возврата из файла сохраняйте. Подключение файлов через `require` разберём в последнем модуле. +В заданиях дописывайте тело указанной функции. Готовую строку возврата из файла сохраняйте. Подключение файлов через `require` разберём дальше в курсе. diff --git a/modules/30-functions/20-multiple-results/ru/README.md b/modules/30-functions/20-multiple-results/ru/README.md index 9cb0ed6..0d73a2e 100644 --- a/modules/30-functions/20-multiple-results/ru/README.md +++ b/modules/30-functions/20-multiple-results/ru/README.md @@ -19,9 +19,17 @@ local function divide(value, divisor) return value // divisor, value % divisor end -print(divide(17, 5)) -- 3 and 2, separated by a tab -print(divide(17, 5), 'done') -- 3 and done -print((divide(17, 5))) -- 3 +print(divide(17, 5)) +print(divide(17, 5), 'done') +print((divide(17, 5))) +``` + +`print` разделяет несколько аргументов табуляцией. + +```text +3 2 +3 done +3 ``` В первом вызове `print` получает оба результата. Во втором после вызова есть ещё выражение, поэтому от `divide` остаётся только первый результат. Скобки вокруг самого вызова тоже сворачивают результаты до одного. diff --git a/modules/30-functions/30-function-values/ru/README.md b/modules/30-functions/30-function-values/ru/README.md index 4a53c2e..b04eb99 100644 --- a/modules/30-functions/30-function-values/ru/README.md +++ b/modules/30-functions/30-function-values/ru/README.md @@ -23,7 +23,7 @@ print(apply(math.abs, -5)) -- 5 `apply` не знает, что именно делает операция. Она отвечает только за вызов с переданным значением. Такой параметр помогает использовать общий порядок действий с разными вычислениями. -Для короткой операции подходит анонимная функция. Выражение `function(...) ... end` создаёт функцию без отдельного имени. +Для короткой операции подходит анонимная функция. Выражение `function(value) return value + 3 end` создаёт функцию без отдельного имени. ```lua local function apply(operation, value) @@ -36,4 +36,10 @@ end, 7) print(result) -- 10 ``` -Если передать `math.abs(-5)`, вызывающий код сначала вычислит результат `5`. Тогда `apply` получит число вместо функции. Передавайте имя без вызова, когда другая функция должна сама выбрать момент выполнения. +Если передать `math.abs(-5)`, вызывающий код сначала вычислит результат `5`. Тогда `apply` получит число вместо функции. + +```text +lua: index.lua:2: attempt to call a number value (local 'operation') +``` + +Передавайте имя без вызова, когда другая функция должна сама выбрать момент выполнения. diff --git a/modules/30-functions/40-closures/ru/README.md b/modules/30-functions/40-closures/ru/README.md index c19932a..09c5c9d 100644 --- a/modules/30-functions/40-closures/ru/README.md +++ b/modules/30-functions/40-closures/ru/README.md @@ -31,4 +31,12 @@ print(counter()) -- 2 Новый вызов `make_counter()` создаст новую локальную переменную `count` и новую функцию, которая работает с ней. Поэтому два независимо созданных счётчика не влияют друг на друга. -Состояние счётчика находится в локальной области внешнего вызова. Делать его глобальным не требуется. В следующем модуле мы подробнее разберём блоки и затенение локальных имён, которые определяют, какую именно переменную захватывает функция. +```lua +local first = make_counter() +local second = make_counter() +print(first()) -- 1 +print(first()) -- 2 +print(second()) -- 1 +``` + +Состояние счётчика находится в локальной области внешнего вызова. Делать его глобальным не требуется. Дальше в курсе мы подробнее разберём блоки и затенение локальных имён, которые определяют, какую именно переменную захватывает функция. diff --git a/modules/40-flow/10-conditionals/ru/README.md b/modules/40-flow/10-conditionals/ru/README.md index 720c56d..684b227 100644 --- a/modules/40-flow/10-conditionals/ru/README.md +++ b/modules/40-flow/10-conditionals/ru/README.md @@ -25,10 +25,17 @@ local function label(amount) end return 'Amount ' .. amount end + +print(label(nil)) -- missing +print(label(5)) -- Amount 5 ``` После раннего `return` оставшиеся инструкции функции не выполняются. Это удобно для проверки отсутствующих данных до основного расчёта. Для диапазона используйте `and`, например `age >= 18 and age < 65`. Запись `18 <= age < 65` сначала получит логическое значение и затем попытается сравнить его с числом. -Короткое замыкание помогает защитить операцию. В условии `amount ~= nil and amount > 0` правая часть выполняется только для существующего значения. Напомним, что сами `0` и `''` в условиях Lua истинны. +```text +lua: index.lua:2: attempt to compare boolean with number +``` + +Короткое замыкание помогает защитить операцию. В условии `amount ~= nil and amount > 0` правая часть выполняется только для существующего значения. Сами `0` и `''` в условиях Lua истинны. diff --git a/modules/40-flow/20-while-repeat/ru/README.md b/modules/40-flow/20-while-repeat/ru/README.md index 512b750..ffcccf2 100644 --- a/modules/40-flow/20-while-repeat/ru/README.md +++ b/modules/40-flow/20-while-repeat/ru/README.md @@ -15,13 +15,22 @@ print(value) -- 16 Цикл `repeat` сначала выполняет тело, затем проверяет условие после `until`. Он завершается, когда условие становится истинным. Дополнительный `end` здесь не нужен. ```lua -local value = 10 +local value = 5 repeat value = value - 1 until value <= 7 -print(value) -- 7 +print(value) -- 4 ``` -`repeat` всегда проходит тело хотя бы один раз. Локальные переменные тела видны в условии `until`, поскольку условие входит в ту же область видимости. +Условие `value <= 7` было истинным ещё до цикла, но тело всё равно выполнилось. `repeat` всегда проходит тело хотя бы один раз. Локальные переменные тела видны в условии `until`, поскольку условие входит в ту же область видимости. + +```lua +local count = 0 +repeat + count = count + 1 + local square = count * count +until square > 10 +print(count) -- 4 +``` Выбирайте форму по моменту проверки. Когда работа не нужна для уже готового результата, подходит `while`. Когда сначала нужна попытка и затем оценка её результата, подходит `repeat`. В обоих случаях состояние должно меняться так, чтобы цикл мог закончиться. diff --git a/modules/40-flow/30-for/ru/README.md b/modules/40-flow/30-for/ru/README.md index 22290c5..cd5da9e 100644 --- a/modules/40-flow/30-for/ru/README.md +++ b/modules/40-flow/30-for/ru/README.md @@ -12,11 +12,17 @@ end ```lua for index = 5, 1, -2 do - print(index) -- 5, then 3, then 1 + print(index) end ``` -При положительном шаге цикл заканчивается после превышения конечной границы. При отрицательном он заканчивается после перехода ниже неё. Если начальные границы не допускают ни одного прохода, тело сразу пропускается. Нулевой шаг в Lua 5.4 вызывает ошибку. +Программа выведет `5`, `3` и `1`, каждое число на отдельной строке. + +При положительном шаге цикл заканчивается после превышения конечной границы. При отрицательном он заканчивается после перехода ниже неё. Если начальное значение уже лежит за конечной границей, например в `for index = 3, 1`, тело не выполняется ни разу. Нулевой шаг вызывает ошибку. + +```text +lua: index.lua:1: 'for' step is zero +``` `break` завершает ближайший окружающий цикл. @@ -29,4 +35,14 @@ for index = 1, 10 do end ``` -Будут выведены только первые три числа. После `break` выполнение продолжится за `end` цикла. В стандартном Lua 5.4 нет отдельного оператора `continue`. Чтобы пропустить часть тела, можно ограничить её условием `if`. +Будут выведены только первые три числа. После `break` выполнение продолжится за `end` цикла. В Lua нет отдельного оператора `continue`. Чтобы пропустить часть тела, можно ограничить её условием `if`. + +```lua +for index = 1, 5 do + if index % 2 == 1 then + print(index) + end +end +``` + +Чётные значения пропускаются, программа выведет `1`, `3` и `5`. diff --git a/modules/40-flow/40-scope/ru/README.md b/modules/40-flow/40-scope/ru/README.md index a618592..8d171af 100644 --- a/modules/40-flow/40-scope/ru/README.md +++ b/modules/40-flow/40-scope/ru/README.md @@ -27,4 +27,35 @@ print(value) -- 10 Область нового локального имени начинается после его объявления. В записи `local value = value + 1` правая часть использует предыдущее доступное `value`. -Блоки условий и циклов задают такие же границы локальных имён. Замыкание сохраняет доступ к той переменной, которую видело в месте своего определения. Создание другого локального имени с тем же написанием позже не переключает уже созданную функцию на новую переменную. +```lua +local value = 10 +do + local value = value + 1 + print(value) -- 11 +end +print(value) -- 10 +``` + +Чтобы значение из блока пережило его `end`, объявите переменную до блока и присвойте её внутри. + +```lua +local result +do + local temporary = 20 + result = temporary + 1 +end +print(result) -- 21 +``` + +Блоки условий и циклов задают такие же границы локальных имён. + +Замыкание сохраняет доступ к той переменной, которую видело в месте своего определения. Создание другого локального имени с тем же написанием позже не переключает уже созданную функцию на новую переменную. + +```lua +local value = 10 +local function show() + return value +end +local value = 99 +print(show()) -- 10 +``` diff --git a/modules/50-tables/20-records/ru/README.md b/modules/50-tables/20-records/ru/README.md index 6db8e0e..126703d 100644 --- a/modules/50-tables/20-records/ru/README.md +++ b/modules/50-tables/20-records/ru/README.md @@ -15,7 +15,7 @@ print(user[field]) -- Mira print(user['display name']) -- Mira K. ``` -`user.field` обратился бы к буквальному ключу `'field'`. Его в примере нет. Таблицы также допускают ключи других типов, кроме `nil` и числового NaN. Числовой ключ `1` и строковый ключ `'1'` различаются. +`user.field` обратился бы к буквальному ключу `'field'`. Его в примере нет. Таблицы также допускают ключи других типов, кроме `nil` и NaN, нечислового значения вроде результата `0 / 0`. Числовой ключ `1` и строковый ключ `'1'` различаются. Присваивание таблицы копирует ссылку на неё. Две переменные могут обозначать один изменяемый объект. diff --git a/modules/50-tables/40-ipairs/ru/README.md b/modules/50-tables/40-ipairs/ru/README.md index fe3040e..c1c413f 100644 --- a/modules/50-tables/40-ipairs/ru/README.md +++ b/modules/50-tables/40-ipairs/ru/README.md @@ -7,6 +7,12 @@ for index, price in ipairs(prices) do end ``` +```text +1 10 +2 20 +3 30 +``` + Это общая форма цикла `for ... in ... do ... end`. Функция `ipairs` подготавливает обход целых индексов начиная с `1`. На каждом проходе переменные `index` и `price` получают очередную позицию и значение. `print` разделяет несколько аргументов табуляцией. Обход останавливается на первом отсутствующем значении, то есть `nil`. Значение `false` остановкой не является. Поэтому `ipairs` подходит для непрерывной последовательности. @@ -18,7 +24,7 @@ for index, flag in ipairs(flags) do end ``` -Будут обработаны все три элемента. Если удалить вторую позицию через присваивание `nil`, обход завершится до третьей. Именованные поля `ipairs` тоже не перебирает. +Будут обработаны все три элемента. Если удалить вторую позицию через присваивание `nil`, обход остановится на ней и третий элемент не обработает. Именованные поля `ipairs` тоже не перебирает. Когда индекс не нужен, его обычно называют `_`, показывая читателю, что значение намеренно пропускается. diff --git a/modules/50-tables/50-pairs/ru/README.md b/modules/50-tables/50-pairs/ru/README.md index 551a89b..079b056 100644 --- a/modules/50-tables/50-pairs/ru/README.md +++ b/modules/50-tables/50-pairs/ru/README.md @@ -34,6 +34,11 @@ for _, name in ipairs(names) do end ``` +```text +apples 3 +pears 2 +``` + Обход отсортированных строковых ключей через `ipairs` задаёт явный порядок вывода. Присваивание `stock.apples = nil` удаляет поле. После этого его не будет в обходе. Добавление нового поля во время обхода делает поведение `pairs` неопределённым. Изменять и удалять существующие поля можно. В наших задачах изменение набора данных и обход выполняются отдельными шагами. diff --git a/modules/50-tables/60-nested/ru/README.md b/modules/50-tables/60-nested/ru/README.md index 637f584..6799d34 100644 --- a/modules/50-tables/60-nested/ru/README.md +++ b/modules/50-tables/60-nested/ru/README.md @@ -23,7 +23,7 @@ for _, product in ipairs(products) do end ``` -Изменение `product.price` внутри цикла изменило бы запись в исходном списке. Это следствие ссылочной семантики таблиц, которую мы разбирали раньше. +Изменение `product.price` внутри цикла изменило бы запись в исходном списке. Это следствие ссылочной семантики таблиц. Для поиска удобно вернуть подходящую запись сразу из цикла. Если обход завершился без совпадения, функция может вернуть `nil`. @@ -36,8 +36,15 @@ local function find_by_price(products, expected_price) end return nil end + +local products = { + { name = 'Tea', price = 250 }, + { name = 'Coffee', price = 400 }, +} +print(find_by_price(products, 400).name) -- Coffee +print(find_by_price(products, 100)) -- nil ``` Ранний возврат завершает и цикл, и функцию. Явный `return nil` показывает соглашение для отсутствующего результата. Получатель должен проверить его до обращения к полям. -При нескольких совпадениях такой поиск вернёт первое по порядку последовательности. Это поведение нужно отразить в условии задания, чтобы вызывающий код мог на него рассчитывать. +При нескольких совпадениях такой поиск вернёт первую подходящую запись в порядке последовательности, и вызывающий код может на это рассчитывать. diff --git a/modules/50-tables/70-varargs/ru/README.md b/modules/50-tables/70-varargs/ru/README.md index c421c1a..6c4a3c0 100644 --- a/modules/50-tables/70-varargs/ru/README.md +++ b/modules/50-tables/70-varargs/ru/README.md @@ -19,6 +19,10 @@ print(arguments[2]) -- nil `ipairs` остановится на второй позиции. Чтобы обработать все переданные позиции, нужен числовой цикл от `1` до `arguments.n`. Функция `select('#', ...)` тоже возвращает количество аргументов, включая `nil`. +```lua +print(select('#', 'first', nil, 'third')) -- 3 +``` + Для обратного преобразования таблицы в несколько значений используется `table.unpack`. Явные границы сохраняют позиции, которые содержат `nil`. ```lua @@ -26,4 +30,8 @@ local arguments = table.pack('first', nil, 'third') print(table.unpack(arguments, 1, arguments.n)) ``` +```text +first nil third +``` + Без явной конечной границы `table.unpack` использует `#`, что не подходит таблице с пропусками. Используйте пару `table.pack` и `table.unpack(arguments, 1, arguments.n)`, когда важно передать набор аргументов без потерь. diff --git a/modules/60-modules/10-modules/ru/README.md b/modules/60-modules/10-modules/ru/README.md index f21e3a3..1e0b338 100644 --- a/modules/60-modules/10-modules/ru/README.md +++ b/modules/60-modules/10-modules/ru/README.md @@ -25,4 +25,4 @@ print(pricing.total(20, 3)) -- 60 Возвращённое значение кешируется в `package.loaded`. Повторный `require` того же имени обычно возвращает уже загруженное значение. Поэтому таблица модуля может разделять состояние между вызывающими частями программы. Имя модуля указывается строкой, а не путём с расширением. -В предыдущих заданиях строка `return function_name` возвращала из файла одну функцию. Таблица экспорта позволяет вернуть несколько связанных операций под именами. В упражнении готовый модуль уже находится в каталоге упражнения, из которого запускается проверка. Устанавливать пакеты не требуется. Обычно `require` размещают в начале файла. Вызов внутри функции тоже использует кеш и не загружает модуль заново. +Строка `return function_name` возвращает из файла одну функцию. Таблица экспорта позволяет вернуть несколько связанных операций под именами. В упражнении готовый модуль уже находится в каталоге упражнения, из которого запускается проверка. Устанавливать пакеты не требуется. Обычно `require` размещают в начале файла. Вызов внутри функции тоже использует кеш и не загружает модуль заново. diff --git a/modules/60-modules/20-errors/ru/README.md b/modules/60-modules/20-errors/ru/README.md index e1364c2..1362187 100644 --- a/modules/60-modules/20-errors/ru/README.md +++ b/modules/60-modules/20-errors/ru/README.md @@ -2,6 +2,20 @@ Lua позволяет остановить вычисление ошибкой Некоторые функции сообщают об ожидаемой неудаче обычными результатами. Например, `tonumber('text')` возвращает `nil`. Собственная функция может дополнительно вернуть сообщение. Вызывающий код сам проверяет такой результат. +```lua +local function parse_price(text) + local price = tonumber(text) + if price == nil then + return nil, 'price must be a number' + end + return price +end + +local price, message = parse_price('free') +print(price) -- nil +print(message) -- price must be a number +``` + `error(message)` прерывает выполнение. По умолчанию в сообщение добавляется расположение вызова. Если нужен заранее определённый текст без префикса, можно указать уровень `0`. ```lua @@ -30,6 +44,15 @@ print(ok) -- false print(result) -- positive value expected ``` +Значением ошибки бывает не только строка. `error` принимает любое значение, например таблицу, и `pcall` вернёт её без изменений. + +```lua +local problem = { code = 404 } +local ok, value = pcall(error, problem) +print(ok) -- false +print(value.code) -- 404 +``` + Важно передать саму функцию. Запись `pcall(positive(-1))` сначала вызовет `positive` без защиты. На внешней границе можно перевести ошибку в соглашение `nil, message`, сохранив детали для вызывающего кода. При этом проверяется флаг `ok`, поскольку успешный результат функции сам может быть равен `false` или `nil`.