.\"Ruby is copyrighted by Yukihiro Matsumoto . .Dd August 11, 2019 .Dt IRB \&1 "Ruby Programmer's Reference Guide" .Os UNIX .Sh "نام (NAME)" .Nm irb .Nd پوسته تعاملی Ruby .Sh "خلاصه دستور (SYNOPSIS)" .Nm .Op Fl -version .Op Fl dfUw .Op Fl I Ar directory .Op Fl r Ar library .Op Fl E Ar external Ns Op : Ns Ar internal .Op Fl W Ns Op Ar level .Op Fl - Ns Oo no Oc Ns inspect .Op Fl - Ns Oo no Oc Ns multiline .Op Fl - Ns Oo no Oc Ns singleline .Op Fl - Ns Oo no Oc Ns echo .Op Fl - Ns Oo no Oc Ns colorize .Op Fl - Ns Oo no Oc Ns autocomplete .Op Fl - Ns Oo no Oc Ns verbose .Op Fl -prompt Ar mode .Op Fl -prompt-mode Ar mode .Op Fl -inf-ruby-mode .Op Fl -simple-prompt .Op Fl -noprompt .Op Fl -tracer .Op Fl -back-trace-limit Ar n .Op Fl - .Op program_file .Op argument ... .Pp .Sh "توضیحات (DESCRIPTION)" .Nm یک محیط REPL (حلقه خواندن\-ارزیابی\-چاپ یا read-eval-print loop) برای برنامه‌های Ruby است. .Pp .Sh "گزینه‌ها (OPTIONS)" .Bl -tag -width "1234567890123" -compact .Pp .It Fl -version نسخه .Nm را چاپ می‌کند. .Pp .It Fl E Ar external Ns Op : Ns Ar internal .It Fl -encoding Ar external Ns Op : Ns Ar internal مشابه `ruby -E` عمل می‌کند. مقدار(های) پیش‌فرض را برای کدگذاری‌های خارجی و کدگذاری داخلی مشخص می‌کند. مقادیر باید با دو‌نقطه (:) از هم جدا شوند. .Pp می‌توانید مقدار مربوط به کدگذاری‌های داخلی را حذف کنید؛ در این صورت، مقدار .Pf ( Li "Encoding.default_internal" ) برابر nil خواهد بود. .Pp .It Fl I Ar path مشابه `ruby -I` عمل می‌کند. دایرکتوری .Li $LOAD_PATH را مشخص می‌کند. .Pp .It Fl U مشابه `ruby -U` عمل می‌کند. مقدار پیش‌فرض را برای کدگذاری‌های داخلی .Pf ( Li "Encoding.default_internal" ) روی UTF-8 تنظیم می‌کند. .Pp .It Fl d مشابه `ruby -d` عمل می‌کند. متغیر .Li $DEBUG را برابر با true قرار می‌دهد. .Pp .It Fl f از خواندن فایل .Pa ~/.irbrc جلوگیری می‌کند. .Pp .It Fl w مشابه `ruby -w` عمل می‌کند. .Pp .Pp .It Fl W مشابه `ruby -W` عمل می‌کند. .Pp .It Fl h .It Fl -help خلاصه‌ای از گزینه‌ها را چاپ می‌کند. .Pp .It Fl r Ar library مشابه `ruby -r` عمل می‌کند. باعث می‌شود irb کتابخانه را با استفاده از require بارگذاری کند. .Pp .It Fl -inspect از `inspect` برای خروجی استفاده می‌کند (پیش‌فرض، به جز در حالت bc). .Pp .It Fl -noinspect از inspect برای خروجی استفاده نمی‌کند. .Pp .It Fl -multiline از ماژول ویرایشگر چندخطی (multiline) استفاده می‌کند. .Pp .It Fl -nomultiline از ماژول ویرایشگر چندخطی استفاده نمی‌کند. .Pp .It Fl -singleline از ماژول ویرایشگر تک‌خطی (singleline) استفاده می‌کند. .Pp .It Fl -nosingleline از ماژول ویرایشگر تک‌خطی استفاده نمی‌کند. .Pp .Pp .It Fl -extra-doc-dir افزودن یک دایرکتوری مستندات اضافی برای کادر گفتگوی مستندات. .Pp .Pp .It Fl -echo نمایش نتیجه (پیش‌فرض). .Pp .It Fl -noecho عدم نمایش نتیجه. .Pp .Pp .It Fl -echo-on-assignment نمایش نتیجه هنگام انتساب. .Pp .It Fl -noecho-on-assignment عدم نمایش نتیجه هنگام انتساب. .Pp .It Fl -truncate-echo-on-assignment نمایش نتیجه کوتاه‌شده هنگام انتساب (پیش‌فرض). .Pp .Pp .It Fl -colorize استفاده از رنگ‌آمیزی. .Pp .It Fl -nocolorize عدم استفاده از رنگ‌آمیزی. .Pp .Pp .It Fl -autocomplete استفاده از تکمیل خودکار (autocompletion). .Pp .It Fl -noautocomplete عدم استفاده از تکمیل خودکار. .Pp .Pp .It Fl -regexp-completor استفاده از تکمیل مبتنی بر regexp. .Pp .It Fl -type-completor استفاده از تکمیل مبتنی بر type. .Pp .Pp .It Fl -verbose نمایش جزئیات. .Pp .It Fl -noverbose عدم نمایش جزئیات. .Pp .It Fl -prompt Ar mode .It Fl -prompt-mode Ar mode تغییر حالت اعلان (prompt). حالت‌های اعلان از پیش تعریف‌شده عبارتند از `default`، `simple`، `xmp` و `inf-ruby`. .Pp .It Fl -inf-ruby-mode از اعلان مناسب برای inf-ruby-mode در emacs استفاده می‌کند. گزینه‌های --multiline و --singleline را غیرفعال می‌کند. .Pp .It Fl -simple-prompt اعلان‌ها را ساده می‌کند. .Pp .It Fl -noprompt حالت بدون اعلان. .Pp .It Fl -tracer ردیابی (trace) را برای هر اجرای دستورات نمایش می‌دهد. .Pp .It Fl -back-trace-limit Ar n تعداد .Ar n مورد ابتدایی و .Ar n مورد انتهایی از ردگیری پشته (backtrace) را نمایش می‌دهد. مقدار پیش‌فرض 16 است. .El .Pp .Sh "محیط (ENVIRONMENT)" .Bl -tag -compact -width "IRB_USE_AUTOCOMPLETE" .It Ev IRB_LANG لوکال (locale) مورد استفاده برای .Nm . .Pp .It Ev IRBRC مسیر فایل راه‌اندازی اولیه شخصی. .Pp .It Ev XDG_CONFIG_HOME دستور .Nm از XDG_CONFIG_HOME پیروی می‌کند. اگر این متغیر تنظیم شده باشد و .Ev IRBRC تنظیم نشده باشد، فایل .Pa $XDG_CONFIG_HOME/irb/irbrc به عنوان فایل راه‌اندازی اولیه شخصی بارگذاری می‌شود. .Pp .It Ev RI_PAGER دستور مشخص‌شده به عنوان صفحه‌بند (pager) استفاده خواهد شد. .Pp .It Ev PAGER اگر .Ev RI_PAGER تنظیم نشده باشد، دستور مشخص‌شده به عنوان صفحه‌بند استفاده خواهد شد. .Pp .It Ev VISUAL مقدار آن برای باز کردن فایل‌ها توسط دستور edit استفاده خواهد شد. .Pp .It Ev EDITOR اگر .Ev VISUAL تنظیم نشده باشد، مقدار آن برای باز کردن فایل‌ها توسط دستور edit استفاده خواهد شد. .Pp .It Ev NO_COLOR اختصاص هر مقداری به آن، رنگ‌آمیزی را غیرفعال می‌کند. .Pp .It Ev IRB_USE_AUTOCOMPLETE اختصاص مقدار .Sy false به آن، تکمیل خودکار را غیرفعال می‌کند. .Pp .It Ev IRB_COMPLETOR رفتار تکمیل خودکار. مقادیر مجاز عبارتند از .Sy regexp یا .Sy type . .Pp .It Ev IRB_COPY_COMMAND برنامه پیش‌فرض مورد استفاده برای تعامل با حافظه موقت (clipboard) سیستم را لغو و بازنویسی می‌کند. .El .Pp همچنین .Nm به همان متغیرهای .Xr ruby 1 وابسته است. .Pp .Sh "فایل‌ها (FILES)" .Bl -tag -compact .It Pa ~/.irbrc فایل راه‌اندازی اولیه شخصی irb. اگر .Ev IRBRC تنظیم شده باشد، به جای آن .Pa $IRBRC خوانده می‌شود. اگر .Ev IRBRC تنظیم نشده باشد و .Ev XDG_CONFIG_HOME تنظیم شده باشد، .Pa $XDG_CONFIG_HOME/irb/irbrc بارگذاری می‌شود. .Pp .El .Pp .Sh "مثال‌ها (EXAMPLES)" .Dl % irb .Dl irb(main):001:0> Ic 1 + 1 .Dl 2 .Dl irb(main):002:0> Ic def t(x) .Dl irb(main):003:1> Ic x + 1 .Dl irb(main):004:1> Ic end .Dl => :t .Dl irb(main):005:0> Ic t(3) .Dl => 4 .Dl irb(main):006:0> Ic if t(3) == 4 .Dl irb(main):007:1> Ic p :ok .Dl irb(main):008:1> Ic end .Dl :ok .Dl => :ok .Dl irb(main):009:0> Ic quit .Dl % .Pp .Sh "همچنین ببینید (SEE ALSO)" .Xr ruby 1 . .Pp .Sh "گزارش باگ‌ها (BUGS)" .Bl -bullet .It آسیب‌پذیری‌های امنیتی باید از طریق ایمیل به .Mt security@ruby-lang.org گزارش شوند. مشکلات گزارش‌شده پس از برطرف شدن منتشر خواهند شد. .Pp .It سایر باگ‌ها و درخواست‌های قابلیت‌های جدید را می‌توان از طریق سامانه رهگیری مشکلات روبی .Pq Lk https://bugs.ruby-lang.org . گزارش کرد. آسیب‌پذیری‌های امنیتی را از طریق این سامانه گزارش نکنید، زیرا این سامانه آسیب‌پذیری‌ها را بلافاصله منتشر می‌کند. .El .Sh "نویسندگان (AUTHORS)" نوشته‌شده توسط Keiju ISHITSUKA.