Краткий справочник

Шпаргалка по языку Lua

Подробный справочник по Lua: основы синтаксиса, таблицы и массивы, циклы, метатаблицы, объектно-ориентированное программирование и стандартная библиотека.

· Опубликовано

Lua — это мощный, быстрый, легковесный встраиваемый скриптовый язык, созданный для расширения приложений.

Основы синтаксиса

Комментарии

-- Однострочный комментарий

--[[
  Многострочный
  комментарий
--]]

Сокращенный вызов функций

Круглые скобки можно опускать, если функция принимает ровно один строковый литерал или литерал таблицы:

print("Hello World")  <==>  print "Hello World"
dofile('app.lua')     <==>  dofile 'app.lua'
config({ x = 1 })     <==>  config{ x = 1 }

Таблицы и массивы

Таблицы — единственная составная структура данных в Lua. Индексация массивов начинается с 1:

-- Пустая таблица
local t = {}

-- Таблица ключ-значение (словарь)
local user = { name = "Alice", age = 30 }
user.role = "admin"
user["email"] = "[email protected]"

-- Последовательный массив (индексация с 1)
local fruits = { "apple", "banana", "cherry" }
print(fruits[1])  -- выводит "apple"
print(#fruits)    -- оператор длины (3)

Управление потоком и циклы

Условные операторы

Только false и nil являются ложными значениями в Lua. Число 0 и пустая строка "" — истинны (truthy):

if score >= 90 then
  grade = "A"
elseif score >= 80 then
  grade = "B"
else
  grade = "C"
end

Циклы

-- Цикл While
local count = 1
while count <= 5 do
  count = count + 1
end

-- Цикл Repeat...until (выполняется минимум один раз)
repeat
  count = count - 1
until count == 0

-- Числовой цикл for: for var = start, stop [, step]
for i = 1, 10, 2 do
  print(i) -- 1, 3, 5, 7, 9
end

-- Универсальный цикл for: ipairs (массивы) и pairs (словари)
for index, value in ipairs(fruits) do
  print(index, value)
end

for key, value in pairs(user) do
  print(key, value)
end

Функции

Определение и возврат нескольких значений

-- Возврат нескольких значений
local function min_max(a, b)
  if a < b then
    return a, b
  else
    return b, a
  end
end

local minimum, maximum = min_max(10, 5)

-- Переменное число аргументов (varargs)
local function sum(...)
  local s = 0
  for _, v in ipairs({...}) do
    s = s + v
  end
  return s
end

Метатаблицы и ООП

Метатаблицы и метаметоды

local Vector = {}
Vector.__index = Vector

function Vector.new(x, y)
  local instance = setmetatable({}, Vector)
  instance.x = x
  instance.y = y
  return instance
end

-- Метаметод сложения векторов
function Vector.__add(a, b)
  return Vector.new(a.x + b.x, a.y + b.y)
end

function Vector:__tostring()
  return string.format("(%d, %d)", self.x, self.y)
end

local v1 = Vector.new(1, 2)
local v2 = Vector.new(3, 4)
local v3 = v1 + v2
print(v3) -- "(4, 6)"

Справочник метаметодов

Метаметод Событие
__index Чтение несуществующего поля (t[k])
__newindex Запись в несуществующее поле (t[k] = v)
__tostring Преобразование в строку (tostring(t))
__call Вызов таблицы как функции (t())
__add, __sub Сложение (+), вычитание (-)
__mul, __div Умножение (*), деление (/)
__eq, __lt, __le Сравнение (==, <, <=)
__concat Конкатенация строк (..)

API стандартной библиотеки

Строковые функции

string.len("hello")             -- 5 (#"hello" also works)
string.lower("HELLO")           -- "hello"
string.upper("hello")           -- "HELLO"
string.sub("hello", 2, 4)       -- "ell"
string.format("%s = %d", "x", 5)-- "x = 5"
string.gsub("banana", "a", "o") -- "bonono"
string.find("hello world", "wor") -- 7, 9

Функции для работы с таблицами

table.insert(fruits, "orange")     -- Добавление в конец
table.insert(fruits, 1, "grape")   -- Вставка по индексу 1
table.remove(fruits, 1)            -- Удаление первого элемента
table.concat(fruits, ", ")         -- Объединение строк: "apple, banana"
table.sort(fruits)                 -- Сортировка массива на месте

Математические функции

math.abs(-10)         -- 10
math.floor(3.7)       -- 3
math.ceil(3.2)        -- 4
math.max(1, 9, 4)     -- 9
math.random(1, 100)   -- Случайное целое число от 1 до 100

Ссылки

Связанные темы