Rubyの組み込み変数まとめ

この記事では、プログラミング言語Rubyの組み込み変数がまとめられています。

参考URL

定数

class Object (Ruby 3.4 リファレンスマニュアル)

全てのクラスのスーパークラス。 オブジェクトの一般的な振舞いを定義します。

https://docs.ruby-lang.org/ja/latest/class/Object.html

特殊変数

module Kernel (Ruby 3.4 リファレンスマニュアル)

全てのクラスから参照できるメソッドを定義しているモジュール。 [[c:Object]] クラスはこのモジュールをインクルードしています。

https://docs.ruby-lang.org/ja/latest/class/Kernel.html

擬似変数

変数と定数 (Ruby 3.4 リファレンスマニュアル)

* [[ref:local]] * [[ref:instance]] * [[ref:class]] * [[ref:class_var_scope]] * [[ref:global]] * [[ref:pseudo]] * [[ref:const]] * [[ref:prio]]

https://docs.ruby-lang.org/ja/latest/doc/spec=2fvariables.html#pseudo

環境変数

環境変数 (Ruby 3.4 リファレンスマニュアル)

Rubyインタプリタは以下の環境変数を参照します。

https://docs.ruby-lang.org/ja/latest/doc/spec=2fenvvars.html

定数

この項目ではclass Objectで定義されている 定数を紹介します。

ARGF -> Object

引数（なければ標準入力）で構成される仮想ファイル。

ARGV -> Array

Rubyスクリプトに与えられた引数を表す配列。

p ARGV

# $ ruby index.rb hoge bar
# ["hoge", "bar"]

DATA -> File

スクリプトの__END__プログラムの終わり以降をアクセスするFileオブジェクト。

puts DATA.gets
puts DATA.gets

__END__
やっはろー
プログラムはここで終わりです。

# $ ruby index.rb
# やっはろー
# プログラムはここで終わりです。

ENV -> Object

環境変数を表す（擬似）連想配列。

pp ENV

# $ ruby index.rb
# {"HOME" => "/Users/home",
#  "LANG" => "ja_JP.UTF-8",
#  "LC_TERMINAL" => "iTerm2",
#  "PATH" => "/ruby/path",
#  "PWD" => "/Users/home/current/directory",
#  "SHELL" => "/usr/bin/bash",
#  "USER" => "ittokunvim",
#  "..." => "..."}

RUBY_COPYRIGHT -> String

Rubyのコピーライトを表す文字列。

puts RUBY_COPYRIGHT

# $ ruby index.rb
# ruby - Copyright (C) 1993-2025 Yukihiro Matsumoto

RUBY_DESCRIPTION -> String

Rubyの詳細を表す文字列。 ruby -vで表示される。

puts RUBY_DESCRIPTION

# $ ruby index.rb
# ruby 3.4.2 (2025-02-15 revision d2930f8e7a) +PRISM [arm64-darwin24]

RUBY_ENGINE -> String

Ruby処理系実装のバージョンを表す文字列。

puts RUBY_ENGINE

# $ ruby index.rb
# ruby

RUBY_PATCHLEVEL -> String

Rubyのパッチレベルを表すIntegerオブジェクト。 パッチレベルとはRubyの各バージョンに対するバグ修正パッチの適用がカウントされている。

puts RUBY_PATCHLEVEL

# $ ruby index.rb
# 28

RUBY_PLATFORM -> String

プラットフォームを表す文字列。

puts RUBY_PLATFORM

# $ ruby index.rb
# arm64-darwin24

RUBY_RELEASE_DATE -> String

Rubyのリリース日を表す文字列。

puts RUBY_RELEASE_DATE

# $ ruby index.rb
# 2025-02-15

RUBY_REVISION -> String

RubyのGITコミットハッシュを表すStringオブジェクト。

puts RUBY_REVISION

# $ ruby index.rb
# d2930f8e7a5db8a7337fa43370940381b420cc3e

RUBY_VERSION -> String

Rubyのバージョンを表す文字列。

puts RUBY_VERSION

# $ ruby index.rb
# 3.4.2

SCRIPT_LINES__ -> Hash

ソースファイル別にまとめられたソースコードの各行。 この定数はデフォルトでは定義されておらず、この定数がハッシュとして定義された後に設定される。

SCRIPT_LINES__ = {}
require 'English'
pp SCRIPT_LINES__

# $ ruby index.rb
# {"/opt/homebrew/Cellar/ruby/3.4.2/lib/ruby/3.4.0/English.rb" =>
#   ["# frozen_string_literal: true\n",
#    "#  Include the English library file in a Ruby script, and you can\n",
#    "#  reference the global variables such as <code>$_</code> using less\n",
#    "#  cryptic names, listed below.\n",
#    ...

STDERR -> IO

標準エラー出力。

# 標準エラー出力先をhoge.txtに変更
$stderr = File.open('./hoge.txt', 'w')
puts hoge # エラー
$stderr = STDERR # 元に戻す

# $ ruby index.rb
#
# hoge.txt
# index.rb:2:in '<main>': undefined local variable or method 'hoge' for main (NameError)
#
# puts hoge
#      ^^^^

STDIN -> IO

標準入力。

STDOUT -> IO

標準出力。

TOPLEVEL_BINDING

トップレベルでのBindingオブジェクト。

特殊変数

特殊変数その他

同じ意味の特殊変数

擬似変数

擬似変数とは以下のような変数となります。

環境変数

Rubyインタプリタは以下の環境変数を参照します。

まとめ

この記事では、Rubyの組み込まれている変数の一覧をざっくり説明してみました。

詳細が知りたい場合は上記の参考URLから飛んでみてみることをお勧めします。

ここでは「こういったものがあるんだよ」ということをこの記事を見た人に知ってもらうことが目的なので、 何かの参考になっていただけたら幸いです。