نام (NAME)

luac - کامپایلر Lua

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

luac [ گزینه‌ها ] [ نام_فایل‌ها ]

توضیحات (DESCRIPTION)

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

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

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

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

گزینه‌ها (OPTIONS)

-l

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

-o file

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

-p

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

-s

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

-v

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

--

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

-

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

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

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

خطاها (DIAGNOSTICS)

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

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

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