Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions modules/10-basics/10-hello-world/ru/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Этот курс поможет освоить Lua как второй язык программирования. Мы предполагаем, что вы уже пишете функции, условия и циклы и знакомы с коллекциями. Здесь мы сосредоточимся на записи Lua и особенностях её поведения, чтобы вы могли перенести эти навыки в новый язык.

Lua часто встраивают в приложения для написания сценариев. Программа на Lua получает возможности от своего окружения. Например, игровые объекты предоставляет движок. В этом курсе мы работаем с обычным Lua 5.4 и его стандартной библиотекой. API движков и отличия Luau в Roblox остаются за границами курса.
Lua часто встраивают в приложения для написания сценариев. Программа на Lua получает возможности от своего окружения. Например, игровые объекты предоставляет движок. В этом курсе мы работаем с обычным Lua и его стандартной библиотекой. API движков и отличия диалекта Luau, на котором пишут в Roblox, остаются за границами курса.

Вызов `print` выводит значение и добавляет перевод строки.

Expand All @@ -18,4 +18,4 @@ Hello, World!

На Code Basics код выполняется в браузерном упражнении. Напишите решение в редакторе и запустите проверку. В заданиях на вывод используйте `print`. Тесты сравнят результат с условием. Устанавливать интерпретатор для этих заданий не нужно.

В следующих уроках разберём несколько возвращаемых значений, замыкания, устройство таблиц и подключение модулей. В каждом задании вы примените изученную возможность Lua.
Дальше в курсе разберём несколько возвращаемых значений, замыкания, устройство таблиц и подключение модулей. В каждом задании вы примените изученную возможность Lua.
2 changes: 1 addition & 1 deletion modules/10-basics/20-syntax/ru/EXERCISE.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Наберите в редакторе исправленную версию программы из условия. Уберите отладочный вывод и закройте строку. Программа должна вывести только `Ready`.
Наберите в редакторе исправленную версию программы из условия. Уберите или закомментируйте отладочный вывод и закройте строку. Программа должна вывести только `Ready`.

Check notice on line 1 in modules/10-basics/20-syntax/ru/EXERCISE.md

View workflow job for this annotation

GitHub Actions / LanguageTool

[LanguageTool] modules/10-basics/20-syntax/ru/EXERCISE.md#L1

Unpaired symbol: ‘'’ seems to be missing (EN_UNPAIRED_QUOTES) URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US Category: PUNCTUATION
Raw output
modules/10-basics/20-syntax/ru/EXERCISE.md:1:198: Unpaired symbol: ‘'’ seems to be missing (EN_UNPAIRED_QUOTES)
 URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses 
 Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
 Category: PUNCTUATION

```text
print('Debug')
Expand Down
10 changes: 10 additions & 0 deletions modules/10-basics/20-syntax/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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')
```
10 changes: 9 additions & 1 deletion modules/10-basics/30-variables/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ print(price) -- 35

Для изменения уже объявленной переменной `local` не повторяют. Оператор `+=` в Lua отсутствует, поэтому обновление записывается целиком.

Присваивание имени без доступного локального объявления записывает значение в глобальное окружение. Такое имя может затронуть другие части программы. В учебных решениях объявляйте переменные через `local`. Область видимости локальных имён мы отдельно разберём на блоках.
Присваивание имени без доступного локального объявления записывает значение в глобальное окружение. Такое имя может затронуть другие части программы. В учебных решениях объявляйте переменные через `local`. Область видимости локальных имён мы отдельно разберём дальше в курсе.

Lua позволяет объявить несколько переменных и присвоить несколько значений одной инструкцией. Все выражения справа вычисляются до записи в переменные слева. Это позволяет обменять значения без временной переменной.

Expand All @@ -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`.
4 changes: 2 additions & 2 deletions modules/10-basics/40-types/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand All @@ -25,6 +25,6 @@ print(amount + 2) -- 17
print(tonumber('hello')) -- nil
```

Некорректная запись числа даёт `nil`. С таким результатом нельзя продолжать арифметику без проверки. Проверять его условием научимся в модуле управления потоком.
Некорректная запись числа даёт `nil`. С таким результатом нельзя продолжать арифметику без проверки. Проверять его условием научимся дальше в курсе.

Для обратного преобразования есть `tostring`. Например, `tostring(15)` возвращает `'15'`. Lua умеет выполнять некоторые неявные преобразования, но явный вызов показывает намерение программы и позволяет отдельно обработать неудачу.
6 changes: 4 additions & 2 deletions modules/20-expressions/10-numbers/ru/README.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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
Expand Down
16 changes: 16 additions & 0 deletions modules/20-expressions/20-strings/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@
print('C:\\temp')
```

Второй вызов выводит две строки, третий выводит одну косую черту.

```text
I'm learning Lua
First
Second
C:\temp
```

Длинные строки между `[[` и `]]` сохраняют переносы строк и не разбирают такие экранирования. Они удобны для фрагмента текста с несколькими строками. Начальный перенос сразу после `[[` Lua пропускает.

```lua
Expand All @@ -17,6 +26,13 @@
print(message)
```

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

Check notice on line 29 in modules/20-expressions/20-strings/ru/README.md

View workflow job for this annotation

GitHub Actions / LanguageTool

[LanguageTool] modules/20-expressions/20-strings/ru/README.md#L29

Two consecutive dots (DOUBLE_PUNCTUATION) Suggestions: `.`, `…` URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-periods Rule: https://community.languagetool.org/rule/show/DOUBLE_PUNCTUATION?lang=en-US Category: PUNCTUATION
Raw output
modules/20-expressions/20-strings/ru/README.md:29:88: Two consecutive dots (DOUBLE_PUNCTUATION)
 Suggestions: `.`, `…`
 URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-periods 
 Rule: https://community.languagetool.org/rule/show/DOUBLE_PUNCTUATION?lang=en-US
 Category: PUNCTUATION

```text
First
Second
```

Для конкатенации используется `..`. Оператор не добавляет пробелов и создаёт новое значение. Исходные строки остаются прежними.

```lua
Expand Down
2 changes: 1 addition & 1 deletion modules/20-expressions/30-string-library/ru/EXERCISE.md
Original file line number Diff line number Diff line change
@@ -1 +1 @@
Из переменной `code` извлеките первые три символа через `string.sub`, переведите результат в верхний регистр через `string.upper` и выведите. Затем выведите последние четыре символа исходной строки.
Из переменной `code` извлеките первые три символа через `string.sub`, переведите результат в верхний регистр через `string.upper` и выведите. Затем выведите последние четыре символа исходной строки. В `code` только ASCII, поэтому каждый символ занимает один байт.
14 changes: 12 additions & 2 deletions modules/20-expressions/30-string-library/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion modules/20-expressions/40-logic/ru/EXERCISE.md
Original file line number Diff line number Diff line change
@@ -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`.
18 changes: 16 additions & 2 deletions modules/20-expressions/40-logic/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
10 changes: 8 additions & 2 deletions modules/30-functions/10-definition/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` разберём дальше в курсе.
14 changes: 11 additions & 3 deletions modules/30-functions/20-multiple-results/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` остаётся только первый результат. Скобки вокруг самого вызова тоже сворачивают результаты до одного.
Expand Down
Loading
Loading