نام (NAME)

irb — پوسته تعاملی Ruby

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

irb [--version] [-dfUw] [-I directory] [-r library] [-E external[:internal]] [-W[level]] [--[no]inspect] [--[no]multiline] [--[no]singleline] [--[no]echo] [--[no]colorize] [--[no]autocomplete] [--[no]verbose] [--prompt mode] [--prompt-mode mode] [--inf-ruby-mode] [--simple-prompt] [--noprompt] [--tracer] [--back-trace-limit n] [--] [program_file] [argument ...]

توضیحات (DESCRIPTION)

irb یک محیط REPL (حلقه خواندن-ارزیابی-چاپ یا read-eval-print loop) برای برنامه‌های Ruby است.

گزینه‌ها (OPTIONS)

--version: نسخه irb را چاپ می‌کند.
-E external[:internal]
--encoding external[:internal]: مشابه `ruby -E` عمل می‌کند. مقدار(های) پیش‌فرض را برای کدگذاری‌های خارجی و کدگذاری داخلی مشخص می‌کند. مقادیر باید با دو‌نقطه (:) از هم جدا شوند.
می‌توانید مقدار مربوط به کدگذاری‌های داخلی را حذف کنید؛ در این صورت، مقدار (Encoding.default_internal) برابر nil خواهد بود.
-I path: مشابه `ruby -I` عمل می‌کند. دایرکتوری $LOAD_PATH را مشخص می‌کند.
-U: مشابه `ruby -U` عمل می‌کند. مقدار پیش‌فرض را برای کدگذاری‌های داخلی (Encoding.default_internal) روی UTF-8 تنظیم می‌کند.
-d: مشابه `ruby -d` عمل می‌کند. متغیر $DEBUG را برابر با true قرار می‌دهد.
-f: از خواندن فایل ~/.irbrc جلوگیری می‌کند.
-w: مشابه `ruby -w` عمل می‌کند.
-W: مشابه `ruby -W` عمل می‌کند.
-h
--help: خلاصه‌ای از گزینه‌ها را چاپ می‌کند.
-r library: مشابه `ruby -r` عمل می‌کند. باعث می‌شود irb کتابخانه را با استفاده از require بارگذاری کند.
--inspect: از `inspect` برای خروجی استفاده می‌کند (پیش‌فرض، به جز در حالت bc).
--noinspect: از inspect برای خروجی استفاده نمی‌کند.
--multiline: از ماژول ویرایشگر چندخطی (multiline) استفاده می‌کند.
--nomultiline: از ماژول ویرایشگر چندخطی استفاده نمی‌کند.
--singleline: از ماژول ویرایشگر تک‌خطی (singleline) استفاده می‌کند.
--nosingleline: از ماژول ویرایشگر تک‌خطی استفاده نمی‌کند.
--extra-doc-dir: افزودن یک دایرکتوری مستندات اضافی برای کادر گفتگوی مستندات.
--echo: نمایش نتیجه (پیش‌فرض).
--noecho: عدم نمایش نتیجه.
--echo-on-assignment: نمایش نتیجه هنگام انتساب.
--noecho-on-assignment: عدم نمایش نتیجه هنگام انتساب.
--truncate-echo-on-assignment: نمایش نتیجه کوتاه‌شده هنگام انتساب (پیش‌فرض).
--colorize: استفاده از رنگ‌آمیزی.
--nocolorize: عدم استفاده از رنگ‌آمیزی.
--autocomplete: استفاده از تکمیل خودکار (autocompletion).
--noautocomplete: عدم استفاده از تکمیل خودکار.
--regexp-completor: استفاده از تکمیل مبتنی بر regexp.
--type-completor: استفاده از تکمیل مبتنی بر type.
--verbose: نمایش جزئیات.
--noverbose: عدم نمایش جزئیات.
--prompt mode
--prompt-mode mode: تغییر حالت اعلان (prompt). حالت‌های اعلان از پیش تعریف‌شده عبارتند از `default`، `simple`، `xmp` و `inf-ruby`.
--inf-ruby-mode: از اعلان مناسب برای inf-ruby-mode در emacs استفاده می‌کند. گزینه‌های --multiline و --singleline را غیرفعال می‌کند.
--simple-prompt: اعلان‌ها را ساده می‌کند.
--noprompt: حالت بدون اعلان.
--tracer: ردیابی (trace) را برای هر اجرای دستورات نمایش می‌دهد.
--back-trace-limit n: تعداد n مورد ابتدایی و n مورد انتهایی از ردگیری پشته (backtrace) را نمایش می‌دهد. مقدار پیش‌فرض 16 است.

محیط (ENVIRONMENT)

IRB_LANG: لوکال (locale) مورد استفاده برای irb.
IRBRC: مسیر فایل راه‌اندازی اولیه شخصی.
XDG_CONFIG_HOME: دستور irb از XDG_CONFIG_HOME پیروی می‌کند. اگر این متغیر تنظیم شده باشد و IRBRC تنظیم نشده باشد، فایل $XDG_CONFIG_HOME/irb/irbrc به عنوان فایل راه‌اندازی اولیه شخصی بارگذاری می‌شود.
RI_PAGER: دستور مشخص‌شده به عنوان صفحه‌بند (pager) استفاده خواهد شد.
PAGER: اگر RI_PAGER تنظیم نشده باشد، دستور مشخص‌شده به عنوان صفحه‌بند استفاده خواهد شد.
VISUAL: مقدار آن برای باز کردن فایل‌ها توسط دستور edit استفاده خواهد شد.
EDITOR: اگر VISUAL تنظیم نشده باشد، مقدار آن برای باز کردن فایل‌ها توسط دستور edit استفاده خواهد شد.
NO_COLOR: اختصاص هر مقداری به آن، رنگ‌آمیزی را غیرفعال می‌کند.
IRB_USE_AUTOCOMPLETE: اختصاص مقدار false به آن، تکمیل خودکار را غیرفعال می‌کند.
IRB_COMPLETOR: رفتار تکمیل خودکار. مقادیر مجاز عبارتند از regexp یا type
IRB_COPY_COMMAND: برنامه پیش‌فرض مورد استفاده برای تعامل با حافظه موقت (clipboard) سیستم را لغو و بازنویسی می‌کند.

همچنین irb به همان متغیرهای ruby(1) وابسته است.

فایل‌ها (FILES)

~/.irbrc: فایل راه‌اندازی اولیه شخصی irb. اگر IRBRC تنظیم شده باشد، به جای آن $IRBRC خوانده می‌شود. اگر IRBRC تنظیم نشده باشد و XDG_CONFIG_HOME تنظیم شده باشد، $XDG_CONFIG_HOME/irb/irbrc بارگذاری می‌شود.

مثال‌ها (EXAMPLES)

% irb

irb(main):001:0>
  1 + 1

2

irb(main):002:0>
  def t(x)

irb(main):003:1>
  x + 1

irb(main):004:1>
  end

=> :t

irb(main):005:0>
  t(3)

=> 4

irb(main):006:0>
  if t(3) == 4

irb(main):007:1>
  p :ok

irb(main):008:1>
  end

:ok

=> :ok

irb(main):009:0>
  quit

%

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

ruby(1).

گزارش باگ‌ها (BUGS)

آسیب‌پذیری‌های امنیتی باید از طریق ایمیل به security@ruby-lang.org گزارش شوند. مشکلات گزارش‌شده پس از برطرف شدن منتشر خواهند شد.
سایر باگ‌ها و درخواست‌های قابلیت‌های جدید را می‌توان از طریق سامانه رهگیری مشکلات روبی (https://bugs.ruby-lang.org). گزارش کرد. آسیب‌پذیری‌های امنیتی را از طریق این سامانه گزارش نکنید، زیرا این سامانه آسیب‌پذیری‌ها را بلافاصله منتشر می‌کند.

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

نوشته‌شده توسط Keiju ISHITSUKA.