نام (NAME)

lua - مفسر زبان Lua

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

lua [ options ] [ script [ args ] ]

توضیحات (DESCRIPTION)

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

options داده‌شده (به زیر مراجعه کنید) اجرا شده و سپس برنامهٔ Lua در فایل script بارگذاری و اجرا می‌شود. args ارائه‌شده به صورت رشته‌هایی در یک جدول سراسری با نام arg در دسترس script قرار می‌گیرند. اگر این آرگومان‌ها شامل فاصله یا نویسه‌های ویژهٔ پوسته باشند، باید در کوتیشن (نقل‌قول) قرار گیرند (اما توجه داشته باشید که کوتیشن‌ها توسط پوسته حذف خواهند شد). آرگومان‌ها در arg از ۰ شروع می‌شوند که شامل رشتهٔ 'script' است. اندیس آخرین آرگومان در arg.n ذخیره می‌شود. آرگومان‌های ارائه‌شده در خط فرمان پیش از script، از جمله نام مفسر، در اندیس‌های منفی در arg در دسترس هستند.

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

گزینه‌ها با '-' شروع می‌شوند و در ادامه توضیح داده شده‌اند. می‌توانید از '--' برای نشان دادن پایان گزینه‌ها استفاده کنید.

اگر هیچ آرگومانی داده نشود، در صورتی که ورودی استاندارد یک ترمینال باشد -v -i فرض می‌شود؛ در غیر این صورت، - فرض می‌شود.

در حالت تعاملی، lua به کاربر اعلان نشان می‌دهد، سطرها را از ورودی استاندارد می‌خواند، و آن‌ها را به محض خوانده شدن اجرا می‌کند. اگر سطری حاوی یک دستور کامل نباشد، یک اعلان ثانویه نمایش داده می‌شود و خواندن سطرها تا زمان تشکیل یک دستور کامل یا یافتن یک خطای نحوی ادامه می‌یابد. بنابراین، یک روش برای متوقف کردن خواندن یک دستور ناتمام، تحمیل یک خطای نحوی است: افزودن یک ';' در میانهٔ یک دستور، روشی مطمئن برای ایجاد خطای نحوی است (به جز داخل رشته‌های چندخطی و توضیحات؛ این موارد باید به صراحت بسته شوند). اگر سطری با '=' شروع شود، lua مقادیر تمام عبارت‌های موجود در ادامهٔ سطر را نمایش می‌دهد. عبارت‌ها باید با کاما از هم جدا شوند. اعلان اولیه مقدار متغیر سراسری _PROMPT است، در صورتی که این مقدار یک رشته باشد؛ در غیر این صورت، از اعلان پیش‌فرض استفاده می‌شود. به طور مشابه، اعلان ثانویه مقدار متغیر سراسری _PROMPT2 است. بنابراین، برای تغییر اعلان‌ها، متغیر مربوطه را به رشتهٔ دلخواه خود تنظیم کنید. می‌توانید این کار را پس از فراخوانی مفسر یا در خط فرمان انجام دهید (اما در این حالت اگر رشتهٔ اعلان شامل فاصله باشد باید مراقب کوتیشن‌ها باشید؛ در غیر این صورت ممکن است پوسته دچار اشتباه شود). اعلان‌های پیش‌فرض "> " و ">> " هستند.

گزینه‌ها (OPTIONS)

-

بارگذاری و اجرای ورودی استاندارد به عنوان یک فایل، یعنی به صورت غیرتعاملی، حتی زمانی که ورودی استاندارد یک ترمینال باشد.

-e stat

اجرای دستور stat. اگر stat شامل فاصله، کوتیشن یا دیگر نویسه‌های ویژهٔ پوسته باشد، لازم است آن را داخل کوتیشن قرار دهید.

-i

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

-l name

فراخوانی require('name') پیش از اجرای script. معمولاً برای بارگذاری کتابخانه‌ها استفاده می‌شود.

-v

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

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

luac(1)
http://www.lua.org

خطاها (DIAGNOSTICS)

پیام‌های خطا باید گویا و واضح باشند.

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

R. Ierusalimschy، L. H. de Figueiredo و W. Celes