نام (NAME)

luac - کامپایلر Lua

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

luac [ options ] [ filenames ]

توضیحات (DESCRIPTION)

دستور luac کامپایلر Lua است. این ابزار برنامه‌های نوشته‌شده به زبان برنامه‌نویسی Lua را به فایل‌های باینری حاوی قطعه‌کدهای پیش‌کامپایل‌شده ترجمه می‌کند که بعداً می‌توانند بارگذاری و اجرا شوند.

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

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

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

گزینه‌ها (OPTIONS)

-l

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

-o file

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

-p

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

-s

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

-v

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

--

پایان پردازش گزینه‌ها.

-

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

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

lua(1)
مستندات موجود در lua.org.

خطاها (DIAGNOSTICS)

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

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

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