zh ja ja ja ja ja hbs_lat ja ja ja ja ja zh ja ja ja it ja en ja zh ja hbs_lat ja hbs_lat ja hbs_lat zh ja en hbs_lat ja ja es ja es es ja es en ja ja de ja ur ja ja en fi ja en ja zh ja en ja ja en en ja zh ja hu ja en ja fi ja ja en en ja ru ja ja en ru ja en ja ja hbs_lat ja ru ja lb ja cs ja en ja en ja ja ja en ja ja el fi ja ja ja ja en ja
ruby [ option ...] [ -- ] [ programfile ] [ argument ...]
ここで、option は後述のコマンドラインオプション のいずれかを指定します。-- は、オプション列の終りを明示するために使用できます。programfile は、Ruby スクリプトを記述したファイルです。これを省略したり`-' を指定した場合には標準入力を Ruby スクリプトとみなします。
programfile が `#!' で始まるファイルである場合、特殊な解釈が行われます。詳細は後述のインタプリタ行の解釈 を参照してください
スクリプトの内部形式へのコンパイルのみを行い, 実行しません。コンパイル終了後, 文法エラーが無ければ, "Syntax OK"と出力します。
--copyright
デバッグモードでスクリプトを実行します。$DEBUG を true にします。
--encoding ex[:in]
デフォルトの外部エンコーディングと内部エンコーディングを:区切りで指定します。内部エンコーディングを省略した場合は Encoding.default_internal は nil になります。また、:エンコーディング のように外部エンコーディングを省略した場合は内部エンコーディングのみを変更します。
# 変更しない場合 $ ruby -e 'p Encoding.default_external; p Encoding.default_internal' #  nil # 外部エンコーディングをEUC-JPにする場合 $ ruby -E EUC-JP -e 'p Encoding.default_external; p Encoding.default_internal' #  nil $ ruby --encoding EUC-JP -e 'p Encoding.default_external; p Encoding.default_internal' #  nil # 内部エンコーディングをWindows-31Jにする場合 $ ruby -E :Windows-31J -e 'p Encoding.default_external; p Encoding.default_internal' #  #  $ ruby --encoding :Windows-31J -e 'p Encoding.default_external; p Encoding.default_internal' #  #  # 外部エンコーディングをEUC-JP、内部エンコーディングをWindows-31Jにする場合 $ ruby -E EUC-JP:Windows-31J -e 'p Encoding.default_external; p Encoding.default_internal' #  #  $ ruby --encoding EUC-JP:Windows-31J -e 'p Encoding.default_external; p Encoding.default_internal' #  #
--external-encoding encoding
デフォルトの外部エンコーディングを指定します。
$ ruby --external-encoding EUC-JP -e 'p Encoding.default_external; p Encoding.default_internal' #  nil
--internal-encoding encoding
デフォルトの内部エンコーディングを指定します。
$ ruby --internal-encoding EUC-JP -e 'p Encoding.default_external; p Encoding.default_internal' #  #
--enable feature
指定した feature を有効にします。以下のいずれかを指定できます。
* gems rubygems (無効にするのはデバッグ専用、default: enabled) * did_you_mean did_you_mean (default: enabled) * rubyopt RUBYOPT 環境変数 (default: enabled) * frozen-string-literal 全ての文字列リテラルをfreeze (default: disabled)
指定した feature(--enable を参照)を無効にします。
コマンドラインからスクリプトを指定します。-eオプションを付けた時には引数からスクリプトファイル名を取りません。
-e オプションを複数指定した場合、各スクリプトの間に改行を挟んで解釈します。
以下は等価です。 ruby -e "5.times do |i|" -e "puts i" -e "end" ruby -e "5.times do |i| puts i end" ruby -e "5.times do |i|; puts i; end"
入力フィールドセパレータ($;)に regexp をセットします。
コマンドラインオプションの概要を表示します。
コマンドラインオプションの概要を表示します。-h よりも詳しい情報が表示されます。
-i[extension]
引数で指定されたファイルの内容を置き換える(in-place edit)ことを指定します。元のファイルは拡張子をつけた形で保存されます。拡張子を省略するとバックアップは行われず、変更されたファイルだけが残ります。ただし Win32 では省略出来ません ([ruby-list:38066] 参照)。
% echo matz > /tmp/junk % cat /tmp/junk matz % ruby -p -i.bak -e '$_.upcase!' /tmp/junk % cat /tmp/junk MATZ % cat /tmp/junk.bak matz
-I directory
ファイルをロードするパスを指定(追加)します。指定されたディレクトリはRubyの配列変数($:)に追加されます。
行末の自動処理を行います。まず、$\ を $/ と同じ値に設定し, printでの出力時に改行を付加するようにします。それから, -n フラグまたは-pフラグが指定されていると gets で読み込まれた各行の最後に対して String#chomp!を行います。
このフラグがセットされるとプログラム全体が sed -nやawk のように
while gets ... end
で囲まれているように動作します.
-nフラグとほぼ同じですが, 各ループの最後に変数 $_ の値を出力するようになります。
% echo matz | ruby -p -e '$_.tr! "a-z", "A-Z"' MATZ
スクリプト実行前に feature で指定されるライブラリを Kernel.#require します。 `-n'オプション、`-p'オプションとともに使う時に特に有効です。
スクリプト名に続く, `-'で始まる引数を解釈して, 同名のグローバル変数に値を設定します。`--'なる引数以降は解釈を行ないません。該当する引数は Object::ARGV から取り除かれます。
#! /usr/local/bin/ruby -s # prints "true" if invoked with `-xyz' switch. print "true\n" if $xyz
スクリプト名が`/'で始まっていない場合, 環境変数 PATHの値を使ってスクリプトを探すことを指定します。 これは、#!をサポートしていないマシンで、 #! による実行をエミュレートするために、以下のようにして使うことができます:
#!/bin/sh exec ruby -S -x $0 "$@" #! ruby
システムは最初の行により、スクリプトを/bin/sh に渡します。/bin/shは2行目を実行しRubyインタプリタを起動します。 Rubyインタプリタは-x オプションにより`#!'で始まり, "ruby"という文字列を含む行までを読み飛ばします。
システムによっては $0は必ずしもフルパスを含まないので、`-S'を用いてRubyに必要に応じてスクリプトを探すように指示する必要があります。
不純度チェックを行います。level を指定すると安全度レベルをそのレベルに設定します。level 省略時は 1 を指定したのと同じです。 CGIプログラムなどでは-T1 程度を指定しておく方が良いでしょう。 $SAFE に指定したレベルがセットされます。
冗長モード。起動時にバージョンの表示を行い, 組み込み変数 $VERBOSEをtrueにセットします。この変数がtrueである時, いくつかのメソッドは実行時に冗長なメッセージを出力します。`-v'オプションが指定されて, それ以外の引数がない時にはバージョンを表示した後, 実行を終了します(標準入力からのスクリプトを待たない).
冗長モード。 組み込み変数 $VERBOSE をtrueにセットします。この変数がtrueである時, いくつかのメソッドは実行時に冗長なメッセージを出力します。
Rubyのバージョンを表示します。
バージョンの表示を行う事無く冗長モードになります。
冗長モードを三段階のレベルで指定します。それぞれ以下の通りです。
* -W0: 警告を出力しない * -W1: 重要な警告のみ出力(デフォルト) * -W2 or -W: すべての警告を出力する
組み込み変数 $VERBOSE はそれぞれ nil, false, true に設定されます。
-x[directory]
メッセージ中のスクリプトを取り出して実行します。スクリプトを読み込む時に、`#!'で始まり, "ruby"という文字列を含む行までを読み飛ばします。スクリプトの終りはEOF(ファイルの終り), ^D(コントロールD), ^Z(コントロールZ)または予約語__END__で指定されます。
ディレクトリ名を指定すると、スクリプト実行前に指定されたディレクトリに移動します。
コンパイラデバッグモード。スクリプトを内部表現にコンパイルする時の構文解析の過程を表示します。この表示は非常に冗長なので, コンパイラそのものをデバッグする人以外には必要ないと思います。
コマンドラインに指定したスクリプトが `#!` で始まるファイルで、その行に `ruby` という文字列を含まない場合、その行を読み飛ばします。`#!` に続く文字列が `ruby` という文字列を含む行を見つけたらその行以下を Ruby スクリプトとして実行します。
例えば、以下のようなスクリプトを sh で実行すると sh から Ruby を起動することができます。
#!/bin/sh exec ruby -x "$0" "$@" #!ruby p ARGV puts "Hello, World!"