SysTutorials

Linux Manual Pages › Section 1

irb3-0(1)

UNIX

Name

irb – Interactive Ruby Shell

Synopsis

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

Description

irb is the REPL(read-eval-print loop) environment for Ruby programs.

Options

–version
Prints the version of irb.
-E external [: internal ]
–encoding external [: internal ]
Same as `ruby -E’ . Specifies the default value(s) for external encodings and internal encoding. Values should be separated with colon (:).

You can omit the one for internal encodings, then the value ( Encoding.default_internal ) will be nil.

-I path
Same as `ruby -I’ . Specifies $LOAD_PATH directory
-U
Same as `ruby -U’ . Sets the default value for internal encodings ( Encoding.default_internal ) to UTF-8.
-d
Same as `ruby -d’ . Sets $DEBUG to true.
-f
Suppresses read of ~/.irbrc
-w
Same as `ruby -w’ .
-W
Same as `ruby -W’ .
-h
–help
Prints a summary of the options.
-r library
Same as `ruby -r’. Causes irb to load the library using require.
–inspect
Uses `inspect’ for output (default except for bc mode)
–noinspect
Doesn’t use inspect for output
–multiline
Uses multiline editor module.
–nomultiline
Doesn’t use multiline editor module.
–singleline
Uses singleline editor module.
–nosingleline
Doesn’t use singleline editor module.
–echo
Show result(default).
–noecho
Don’t show result.
–colorize
Use colorization.
–nocolorize
Don’t use colorization.
–verbose
Show details.
–noverbose
Don’t show details.
–prompt mode
–prompt-mode mode
Switch prompt mode. Pre-defined prompt modes are `default’, `simple’, `xmp’ and `inf-ruby’.
–inf-ruby-mode
Uses prompt appropriate for inf-ruby-mode on emacs. Suppresses –multiline and –singleline.
–simple-prompt
Makes prompts simple.
–noprompt
No prompt mode.
–tracer
Displays trace for each execution of commands.
–back-trace-limit n
Displays backtrace top n and tail n The default value is 16.

Environment

IRBRC

Also irb depends on same variables as ruby(1).

Files

~/.irbrc
Personal irb initialization.

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).

Reporting Bugs

Authors

Written by Keiju ISHITSUKA.