نام (NAME)

luac5.2 - کامپایلر زبان برنامه‌نویسی Lua نسخه ۵.۲

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

luac [ options ] [ filenames ]

توضیحات (DESCRIPTION)

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

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

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

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

گزینه‌ها (OPTIONS)

-l

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

-o file

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

-p

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

-s

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

-v

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

--

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

-

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

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

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

عیب‌یابی (DIAGNOSTICS)

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

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

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