نام (NAME)

lua - مفسر لوآ

خلاصه دستور (SYNOPSIS)

lua [ options ] [ script [ args ] ]

توضیحات (DESCRIPTION)

lua یک مفسر مستقل برای زبان لوآ (Lua) است. این برنامه کدهای لوآ را، چه به شکل متن مبدأ یا به صورت باینری از پیش‌کامپایل‌شده، بارگذاری و اجرا می‌کند. (باینری‌های از پیش‌کامپایل‌شده توسط luac، کامپایلر لوآ، خروجی داده می‌شوند.) lua می‌تواند هم به عنوان یک مفسر دسته‌ای و هم به صورت تعاملی استفاده شود.

پس از پردازش options، برنامه لوآ در فایل script بارگذاری و اجرا می‌شود. شناسه‌های args به عنوان رشته‌ها در یک جدول سراسری به نام arg و همچنین به عنوان آرگومان‌های تابع اصلی در دسترس script خواهند بود. هنگامی که بدون آرگومان فراخوانی شود، lua رفتاری معادل با lua -v -i خواهد داشت اگر ورودی استاندارد یک ترمینال باشد، و در غیر این صورت مانند lua - عمل می‌کند.

در حالت تعاملی، lua از کاربر ورودی می‌خواهد، خطوط را از ورودی استاندارد می‌خواند، و آن‌ها را به محض خوانده شدن اجرا می‌کند. اگر خط حاوی یک عبارت باشد، آن عبارت ارزیابی شده و نتیجه چاپ می‌شود. اگر خط حاوی یک دستور کامل نباشد، یک اعلان ثانویه نمایش داده می‌شود و خواندن خطوط ادامه می‌یابد تا یک دستور کامل شکل بگیرد یا یک خطای نحو پیدا شود.

پیش از پردازش گزینه‌های خط فرمان و اسکریپت‌ها، lua محتوای متغیرهای محیطی LUA_INIT_5_5 و LUA_INIT را به همین ترتیب بررسی می‌کند. اگر محتوا به شکل '@filename' باشد، آنگاه filename اجرا می‌شود. در غیر این صورت، فرض می‌شود که محتوا یک عبارت لوآ است و اجرا می‌شود. هنگامی که LUA_INIT_5_5 تعریف شده باشد، LUA_INIT نادیده گرفته می‌شود.

گزینه‌ها (OPTIONS)

-e stat

اجرای دستور stat.

-i

ورود به حالت تعاملی پس از اجرای script.

-l mod

فراخوانی کتابخانه mod در متغیر سراسری mod.

-l g=mod

فراخوانی کتابخانه mod در متغیر سراسری g.

-v

نمایش اطلاعات نسخه.

-E

نادیده گرفتن متغیرهای محیطی.

-W

روشن کردن هشدارها.

--

توقف پردازش گزینه‌ها.

-

توقف پردازش گزینه‌ها و اجرای ورودی استاندارد به عنوان یک فایل.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

متغیرهای محیطی زیر بر اجرای lua تأثیر می‌گذارند. در صورت تعریف شدن، نسخه‌های اختصاصی نگارش اولویت دارند و نسخه‌های عمومی نادیده گرفته می‌شوند.

LUA_INIT, LUA_INIT_5_5

کدی که باید پیش از گزینه‌های خط فرمان و اسکریپت‌ها اجرا شود.

LUA_PATH, LUA_PATH_5_5

مقدار اولیه package.path، مسیری که توسط require برای یافتن بارکننده‌های لوآ استفاده می‌شود.

LUA_CPATH, LUA_CPATH_5_5

مقدار اولیه package.cpath، مسیری که توسط require برای یافتن بارکننده‌های C استفاده می‌شود.

وضعیت خروج (EXIT STATUS)

اگر اسکریپت os.exit را فراخوانی کند، آنگاه lua با همان وضعیت خروج مشخص‌شده خارج می‌شود. در غیر این صورت، lua در صورت نبود خطا با EXIT_SUCCESS (مقدار 0 در سامانه‌های POSIX) و در صورت بروز خطا با EXIT_FAILURE (مقدار 1 در سامانه‌های POSIX) خارج می‌شود. خطاهای رخ‌داده در حالت تعاملی موجب خروج از برنامه نمی‌شوند.

عیب‌یابی (DIAGNOSTICS)

پیام‌های خطا خودتوضیح هستند.

همچنین ببینید (SEE ALSO)

luac(1)
مستندات موجود در lua.org، به‌ویژه بخش ۷ از راهنمای مرجع.

نویسندگان (AUTHORS)

R. Ierusalimschy, L. H. de Figueiredo, W. Celes