زبان برنامه‌نویسی

چیت‌شیت Lua

مرجع سریع Lua برای جدول‌ها، توابع، شرط‌ها، حلقه‌ها و ماژول‌ها. table ساختار مرکزی Lua برای فهرست و نگاشت است؛ `ipairs` برای توالی و `pairs` برای کلیدهای عمومی است و ترتیب دومی تضمین‌شده نیست. local را برای محدودکردن scope به‌کار ببرید. nil و false تنها مقدارهای false در شرط هستند؛ این تفاوت در کنترل جریان مهم است. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.

NOVIN SKILLS / DIGITAL STUDIO

Table به‌عنوان رکورد

کلیدهای نام‌دار برای دادهٔ ساخت‌یافته خوانایی می‌دهند.

1local user = {2  id = 7,3  name = "Ada",4  active = true,5}67print(user.name)

پیمایش فهرست با ipairs

برای دنبالهٔ عددی پیوسته از ipairs استفاده کنید.

1local colors = { "red", "green", "blue" }2for index, color in ipairs(colors) do3  print(index, color)4end

تابع با چند خروجی

تابع می‌تواند چند مقدار برگرداند؛ قرارداد ترتیب آن‌ها را روشن نگه دارید.

1local function divide(a, b)2  if b == 0 then3    return nil, "division by zero"4  end5  return a / b, nil6end

شرط و مقدار پیش‌فرض

از مقدار پیش‌فرض آشکار برای nil استفاده کنید.

1local display_name = name2if display_name == nil or display_name == "" then3  display_name = "Guest"4end

پیمایش کلیدهای table

pairs برای پیمایش map مناسب است، نه ترتیب نمایشی.

1for key, value in pairs(settings) do2  print(key, value)3end

ماژول با return

ماژول معمولاً یک table از API عمومی را برمی‌گرداند.

1local M = {}23function M.clamp(value, minimum, maximum)4  return math.max(minimum, math.min(maximum, value))5end67return M

Metatable برای fallback

__index می‌تواند مقدارهای پیش‌فرض را از table دیگری فراهم کند.

1local defaults = { theme = "system", retries = 3 }2local options = setmetatable({ retries = 5 }, { __index = defaults })34print(options.theme)5print(options.retries)

pcall برای خطای قابل‌بازیابی

pcall موفقیت و خروجی یا خطا را به‌صورت جدا برمی‌گرداند.

1local ok, result = pcall(function()2  return decode(payload)3end)45if not ok then6  print("decode failed:", result)7end

Coroutine پایه

coroutine اجرای تابع را با yield متوقف و بعداً ادامه می‌دهد.

1local worker = coroutine.create(function()2  coroutine.yield("waiting")3  return "done"4end)56print(coroutine.resume(worker))7print(coroutine.resume(worker))

برای استفاده در پروژه

نکات کلیدی

۱
متغیر محلی را با local تعریف کنید تا ناخواسته global نشود.
۲
مقدار تهی nil است و مقدارهای false و nil در شرط false محسوب می‌شوند.
۳
جدول با {} هم آرایه‌مانند و هم نگاشت کلید-مقدار است.
۴
اندیس آرایه‌مانند عموماً از 1 آغاز می‌شود.
۵
تابع: local function add(a, b) return a + b end
۶
شرط با if ... then ... elseif ... else ... end نوشته می‌شود.
۷
حلقه‌ها: for i = 1, n do و while condition do.
۸
طول جدول #t برای بخش ترتیبی مناسب است؛ جدول sparse را جداگانه مدیریت کنید.
۹
ماژول‌ها را با الگوی require پروژه بارگذاری کنید.
۱۰
مقدارهای nil، مرز حلقه و ورودی‌های نامعتبر را در تست پوشش دهید.
۱۱
جدول در Lua هم آرایه و هم map است؛ پیمایش ipairs و pairs رفتار و ترتیب یکسانی ندارند.
۱۲
برای مدیریت خطا از pcall در مرز مناسب استفاده کنید و خطا را بی‌صدا نادیده نگیرید.

چیت‌شیت Lua

Table به‌عنوان رکورد

کلیدهای نام‌دار برای دادهٔ ساخت‌یافته خوانایی می‌دهند.

1local user = {2  id = 7,3  name = "Ada",4  active = true,5}67print(user.name)

پیمایش فهرست با ipairs

برای دنبالهٔ عددی پیوسته از ipairs استفاده کنید.

1local colors = { "red", "green", "blue" }2for index, color in ipairs(colors) do3  print(index, color)4end

تابع با چند خروجی

تابع می‌تواند چند مقدار برگرداند؛ قرارداد ترتیب آن‌ها را روشن نگه دارید.

1local function divide(a, b)2  if b == 0 then3    return nil, "division by zero"4  end5  return a / b, nil6end

شرط و مقدار پیش‌فرض

از مقدار پیش‌فرض آشکار برای nil استفاده کنید.

1local display_name = name2if display_name == nil or display_name == "" then3  display_name = "Guest"4end

پیمایش کلیدهای table

pairs برای پیمایش map مناسب است، نه ترتیب نمایشی.

1for key, value in pairs(settings) do2  print(key, value)3end

ماژول با return

ماژول معمولاً یک table از API عمومی را برمی‌گرداند.

1local M = {}23function M.clamp(value, minimum, maximum)4  return math.max(minimum, math.min(maximum, value))5end67return M

Metatable برای fallback

__index می‌تواند مقدارهای پیش‌فرض را از table دیگری فراهم کند.

1local defaults = { theme = "system", retries = 3 }2local options = setmetatable({ retries = 5 }, { __index = defaults })34print(options.theme)5print(options.retries)

pcall برای خطای قابل‌بازیابی

pcall موفقیت و خروجی یا خطا را به‌صورت جدا برمی‌گرداند.

1local ok, result = pcall(function()2  return decode(payload)3end)45if not ok then6  print("decode failed:", result)7end

Coroutine پایه

coroutine اجرای تابع را با yield متوقف و بعداً ادامه می‌دهد.

1local worker = coroutine.create(function()2  coroutine.yield("waiting")3  return "done"4end)56print(coroutine.resume(worker))7print(coroutine.resume(worker))

برای استفاده در پروژه

نکات کلیدی

۱
متغیر محلی را با local تعریف کنید تا ناخواسته global نشود.
۲
مقدار تهی nil است و مقدارهای false و nil در شرط false محسوب می‌شوند.
۳
جدول با {} هم آرایه‌مانند و هم نگاشت کلید-مقدار است.
۴
اندیس آرایه‌مانند عموماً از 1 آغاز می‌شود.
۵
تابع: local function add(a, b) return a + b end
۶
شرط با if ... then ... elseif ... else ... end نوشته می‌شود.
۷
حلقه‌ها: for i = 1, n do و while condition do.
۸
طول جدول #t برای بخش ترتیبی مناسب است؛ جدول sparse را جداگانه مدیریت کنید.
۹
ماژول‌ها را با الگوی require پروژه بارگذاری کنید.
۱۰
مقدارهای nil، مرز حلقه و ورودی‌های نامعتبر را در تست پوشش دهید.
۱۱
جدول در Lua هم آرایه و هم map است؛ پیمایش ipairs و pairs رفتار و ترتیب یکسانی ندارند.
۱۲
برای مدیریت خطا از pcall در مرز مناسب استفاده کنید و خطا را بی‌صدا نادیده نگیرید.