.\" $Id: lua.man,v 1.14 2024/03/18 06:57:32 lhf Exp $
.TH LUA 1 "$Date: 2024/03/18 06:57:32 $"
.SH "نام (NAME)"
lua \- مفسر لوآ
.SH "خلاصه دستور (SYNOPSIS)"
.B lua
[
.I options
]
[
.I script
[
.I args
]
]
.SH "توضیحات (DESCRIPTION)"
.B lua
یک مفسر مستقل برای زبان لوآ (Lua) است.
این برنامه کدهای لوآ را، چه به شکل متن مبدأ یا
به صورت باینری از پیش‌کامپایل‌شده،
بارگذاری و اجرا می‌کند.
(باینری‌های از پیش‌کامپایل‌شده توسط
.BR luac ،
کامپایلر لوآ، خروجی داده می‌شوند.)
.B lua
می‌تواند هم به عنوان یک مفسر دسته‌ای و هم به صورت تعاملی استفاده شود.
.LP
پس از پردازش
.IR options ،
برنامه لوآ در فایل
.I script
بارگذاری و اجرا می‌شود.
شناسه‌های
.I args
به عنوان رشته‌ها در یک جدول سراسری به نام
.B arg
و همچنین به عنوان آرگومان‌های تابع اصلی در دسترس
.I script
خواهند بود.
هنگامی که بدون آرگومان فراخوانی شود،
.B lua
رفتاری معادل با
.B "lua \-v \-i"
خواهد داشت اگر ورودی استاندارد یک ترمینال باشد،
و در غیر این صورت مانند
.B "lua \-"
عمل می‌کند.
.LP
در حالت تعاملی،
.B lua
از کاربر ورودی می‌خواهد،
خطوط را از ورودی استاندارد می‌خواند،
و آن‌ها را به محض خوانده شدن اجرا می‌کند.
اگر خط حاوی یک عبارت باشد،
آن عبارت ارزیابی شده و نتیجه چاپ می‌شود.
اگر خط حاوی یک دستور کامل نباشد،
یک اعلان ثانویه نمایش داده می‌شود و
خواندن خطوط ادامه می‌یابد تا یک دستور کامل شکل بگیرد یا
یک خطای نحو پیدا شود.
.LP
پیش از پردازش گزینه‌های خط فرمان و اسکریپت‌ها،
.B lua
محتوای متغیرهای محیطی
.B LUA_INIT_5_5
و
.BR LUA_INIT
را به همین ترتیب بررسی می‌کند.
اگر محتوا به شکل
.RI '@ filename '
باشد، آنگاه
.I filename
اجرا می‌شود.
در غیر این صورت، فرض می‌شود که محتوا یک عبارت لوآ است و اجرا می‌شود.
هنگامی که
.B LUA_INIT_5_5
تعریف شده باشد،
.B LUA_INIT
نادیده گرفته می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-e " stat"
اجرای دستور
.IR stat .
.TP
.B \-i
ورود به حالت تعاملی پس از اجرای
.IR script .
.TP
.BI \-l " mod"
فراخوانی کتابخانه
.I mod
در متغیر سراسری
.IR mod .
.TP
.BI \-l " g=mod"
فراخوانی کتابخانه
.I mod
در متغیر سراسری
.IR g .
.TP
.B \-v
نمایش اطلاعات نسخه.
.TP
.B \-E
نادیده گرفتن متغیرهای محیطی.
.TP
.B \-W
روشن کردن هشدارها.
.TP
.B \-\-
توقف پردازش گزینه‌ها.
.TP
.B \-
توقف پردازش گزینه‌ها و اجرای ورودی استاندارد به عنوان یک فایل.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
متغیرهای محیطی زیر بر اجرای
.BR lua
تأثیر می‌گذارند.
در صورت تعریف شدن،
نسخه‌های اختصاصی نگارش اولویت دارند
و نسخه‌های عمومی نادیده گرفته می‌شوند.
.TP
.B LUA_INIT, LUA_INIT_5_5
کدی که باید پیش از گزینه‌های خط فرمان و اسکریپت‌ها اجرا شود.
.TP
.B LUA_PATH, LUA_PATH_5_5
مقدار اولیه package.path،
مسیری که توسط require برای یافتن بارکننده‌های لوآ استفاده می‌شود.
.TP
.B LUA_CPATH, LUA_CPATH_5_5
مقدار اولیه package.cpath،
مسیری که توسط require برای یافتن بارکننده‌های C استفاده می‌شود.
.SH "وضعیت خروج (EXIT STATUS)"
اگر اسکریپت os.exit را فراخوانی کند،
آنگاه
.B lua
با همان وضعیت خروج مشخص‌شده خارج می‌شود.
در غیر این صورت،
.B lua
در صورت نبود خطا با EXIT_SUCCESS (مقدار 0 در سامانه‌های POSIX)
و
در صورت بروز خطا با EXIT_FAILURE (مقدار 1 در سامانه‌های POSIX) خارج می‌شود.
خطاهای رخ‌داده در حالت تعاملی موجب خروج از برنامه نمی‌شوند.
.SH "عیب‌یابی (DIAGNOSTICS)"
پیام‌های خطا خودتوضیح هستند.
.SH "همچنین ببینید (SEE ALSO)"
.BR luac (1)
.br
مستندات موجود در lua.org،
به‌ویژه بخش ۷ از راهنمای مرجع.
.SH "نویسندگان (AUTHORS)"
R. Ierusalimschy,
L. H. de Figueiredo,
W. Celes
.\" EOF