نام (NAME)

luac5.3 - کامپایلر بایت‌کد زبان Lua نسخه ۵.۳

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

luac5.3 [ گزینه‌ها ] [ نام‌فایل‌ها ]

توضیحات (DESCRIPTION)

luac5.3 کامپایلر زبان برنامه‌نویسی Lua است. این ابزار برنامه‌های نوشته‌شده به زبان Lua را به فایل‌های باینری حاوی تکه‌های از‌پیش‌کامپایل‌شده (Precompiled Chunks) تبدیل می‌کند که می‌توان بعداً آن‌ها را بارگذاری و اجرا کرد.

مزایای اصلی از‌پیش‌کامپایل‌کردن عبارتند از: بارگذاری سریع‌تر، محافظت از کد منبع در برابر تغییرات تصادفی کاربر، و بررسی آفلاین نحو (Syntax Checking). از‌پیش‌کامپایل‌کردن به معنی اجرای سریع‌تر نیست، زیرا در Lua تکه‌ها همیشه پیش از اجرا به بایت‌کد تبدیل می‌شوند. luac5.3 تنها این امکان را فراهم می‌کند که آن بایت‌کدها برای اجرای بعدی در یک فایل ذخیره شوند. تکه‌های از‌پیش‌کامپایل‌شده لزوماً کوچک‌تر از فایل منبع متناظر نیستند. هدف اصلی پیش‌کامپایل‌کردن، بارگذاری سریع‌تر است.

در خط فرمان، می‌توانید فایل‌های متنی منبع Lua و فایل‌های باینری از‌پیش‌کامپایل‌شده را با هم ترکیب کنید. luac5.3 یک فایل خروجی واحد شامل بایت‌کدهای ترکیب‌شده برای تمامی فایل‌های داده‌شده تولید می‌کند. اجرای فایل ترکیب‌شده معادل اجرای فایل‌های ارائه‌شده است. به‌صورت پیش‌فرض، فایل خروجی با نام luac.out نام‌گذاری می‌شود، اما می‌توانید این نام را با گزینه -o تغییر دهید.

تکه‌های از‌پیش‌کامپایل‌شده بین معماری‌های مختلف سیستم قابل‌انتقال (Portable) نیستند. علاوه بر این، فرمت داخلی این تکه‌ها با انتشار نسخه‌های جدید Lua احتمالاً تغییر خواهد کرد. همیشه فایل‌های منبع برنامه‌هایی را که پیش‌کامپایل می‌کنید ذخیره و نگهداری نمایید.

گزینه‌ها (OPTIONS)

-l

تولید فهرستی از بایت‌کدهای کامپایل‌شده برای ماشین مجازی Lua. فهرست‌بندی بایت‌کدها برای آشنایی با ماشین مجازی Lua بسیار مفید است. اگر فایلی مشخص نشود، luac5.3 فایل luac.out را بارگذاری کرده و محتویات آن را فهرست می‌کند. از -l -l برای دریافت فهرست کامل استفاده کنید.

-o file

نوشتن خروجی در file به‌جای نام پیش‌فرض luac.out. (می‌توانید از '-' برای خروجی استاندارد استفاده کنید، اما نه در پلتفرم‌هایی که خروجی استاندارد را در حالت متنی باز می‌کنند.) فایل خروجی می‌تواند یکی از فایل‌های داده‌شده باشد، زیرا تمام فایل‌ها پیش از نوشتن فایل خروجی بارگذاری می‌شوند. مراقب باشید فایل‌های مهم را بازنویسی نکنید.

-p

فایل‌ها را بارگذاری می‌کند ولی هیچ فایل خروجی تولید نمی‌کند. عمدتاً برای بررسی نحو و آزمایش تکه‌های از‌پیش‌کامپایل‌شده استفاده می‌شود؛ فایل‌های معیوب هنگام بارگذاری با خطا مواجه می‌شوند. اگر فایلی داده نشود، luac5.3 فایل luac.out را بارگذاری و محتویات آن را آزمایش می‌کند. در صورتی که فایل بدون خطا بارگذاری شود، پیامی نمایش داده نخواهد شد.

-s

حذف اطلاعات اشکال‌زدایی (Debug Information) قبل از نوشتن فایل خروجی. این کار در تکه‌های بسیار بزرگ در مصرف فضا صرفه‌جویی می‌کند، اما در صورت بروز خطا هنگام اجرای تکه، پیام‌های خطا شامل جزئیات کامل همیشگی نخواهند بود. به‌ویژه شماره خطوط و نام متغیرهای محلی حذف می‌شوند.

-v

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

--

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

-

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

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

lua5.3(1), lua(1)
مستندات موجود در وب‌سایت https://www.lua.org

عیب‌یابی (DIAGNOSTICS)

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

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

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