1IRB(1)                 Ruby Programmer's Reference Guide                IRB(1)
2

NAME

4     irb — Interactive Ruby Shell
5

SYNOPSIS

7     irb [--version] [-dfm] [-I directory] [-r library] [--[no]inspect]
8         [--[no]readline] [--prompt mode] [--prompt-mode mode]
9         [--inf-ruby-mode] [--simple-prompt] [--noprompt] [--tracer]
10         [--back-trace-limit n] [--irb_debug n] [--] [program_file]
11         [argument ...]
12

DESCRIPTION

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

OPTIONS

17     --version      Prints the version of irb.
18
19     -E external[:internal]
20     --encoding external[:internal]
21                    Same as `ruby -E' .  Specifies the default value(s) for
22                    external encodings and internal encoding. Values should be
23                    separated with colon (:).
24
25                    You can omit the one for internal encodings, then the
26                    value (Encoding.default_internal) will be nil.
27
28     -I path        Same as `ruby -I' .  Specifies $LOAD_PATH directory
29
30     -U             Same as `ruby -U' .  Sets the default value for internal
31                    encodings (Encoding.default_internal) to UTF-8.
32
33     -d             Same as `ruby -d' .  Sets $DEBUG to true.
34
35     -f             Suppresses read of ~/.irbrc.
36
37     -h
38     --help         Prints a summary of the options.
39
40     -r library     Same as `ruby -r'.  Causes irb to load the library using
41                    require.
42
43     --inspect      Uses `inspect' for output (default except for bc mode)
44
45     --noinspect    Doesn't use inspect for output
46
47     --readline     Uses Readline extension module.
48
49     --noreadline   Doesn't use Readline extension module.
50
51     --prompt mode
52     --prompt-mode mode
53                    Switch prompt mode. Pre-defined prompt modes are
54                    `default', `simple', `xmp' and `inf-ruby'.
55
56     --inf-ruby-mode
57                    Uses prompt appropriate for inf-ruby-mode on emacs.  Sup‐
58                    presses --readline.
59
60     --simple-prompt
61                    Makes prompts simple.
62
63     --noprompt     No prompt mode.
64
65     --tracer       Displays trace for each execution of commands.
66
67     --back-trace-limit n
68                    Displays backtrace top n and tail n.  The default value is
69                    16.
70
71     --irb_debug n  Sets internal debug level to n (not for popular use)
72

ENVIRONMENT

74     IRBRC
75
76     Also irb depends on same variables as ruby(1).
77

FILES

79     ~/.irbrc                          Personal irb initialization.
80

EXAMPLES

82           % irb
83           irb(main):001:0> 1 + 1
84           2
85           irb(main):002:0> def t(x)
86           irb(main):003:1> x+1
87           irb(main):004:1> end
88           => :t
89           irb(main):005:0> t(3)
90           => 4
91           irb(main):006:0> if t(3) == 4
92           irb(main):007:1> p :ok
93           irb(main):008:1> end
94           :ok
95           => :ok
96           irb(main):009:0> quit
97           %
98

SEE ALSO

100     ruby(1).
101

REPORTING BUGS

103     ·   Security vulnerabilities should be reported via an email to
104         security@ruby-lang.org.  Reported problems will be published after
105         being fixed.
106
107     ·   Other bugs and feature requests can be reported via the Ruby Issue
108         Tracking System (https://bugs.ruby-lang.org/).  Do not report secu‐
109         rity vulnerabilities via this system because it publishes the vulner‐
110         abilities immediately.
111

AUTHORS

113     Written by Keiju ISHITSUKA.
114
115UNIX                           November 15, 2012                          UNIX
Impressum