class Symbol + Comparable
クラスの継承リスト: Symbol < Comparable < Object < Kernel < BasicObject
要約
シンボルを表すクラス。シンボルは任意の文字列と一対一に対応するオブジェクトです。
文字列の代わりに用いることもできますが、必ずしも文字列と同じ振る舞いをするわけではありません。 同じ内容のシンボルはかならず同一のオブジェクトです。
シンボルオブジェクトは以下のようなリテラルで得られます。
:symbol :'symbol' %s!symbol! # %記法
生成されたシンボルの一覧は Symbol.all_symbols で得られます。 一番目のリテラルでシンボルを表す場合、`:' の後に は識別子、メソッド名(`!',`?',`=' などの接尾辞を含む)、変数名 (`$'などの接頭辞を含む)、再定義できる演算子のいずれかに適合する ものしか書くことはできません(そうでなければ文法エラーになります)。 そうでない文字列をシンボルにしたい場合は残りの表記か String#intern を使用してください。
シンボルの実装と用途
実装
Rubyの内部実装では、メソッド名や変数名、定数名、クラス名など の`名前'を整数で管理しています。これは名前を直接文字列として処理するよりも 速度面で有利だからです。そしてその整数をRubyのコード上で表現したものがシンボルです。
シンボルは、ソース上では文字列のように見え、内部では整数として扱われる、両者を仲立ちするような存在です。
名前を管理するという役割上、シンボルと文字列は一対一に対応します。 また、文字列と違い、immutable (変更不可)であり、同値ならば必ず同一です。
p "abc" == "abc" #=> true p "abc".equal?("abc") #=> false p :abc == :abc #=> true p :abc.equal?(:abc) #=> true ←同値ならば同一
用途
実用面では、シンボルは文字の意味を明確にします。`名前'を指し示す時など、 文字列そのものが必要なわけではない時に用います。
- ハッシュのキー { :key => "value" }
- アクセサの引数で渡すインスタンス変数名 attr_reader :name
- メソッド引数で渡すメソッド名 __send__ :to_s
- C の enum 的な使用 (値そのものは無視してよい場合)
シンボルを使うメリットは
- 新しく文字列を生成しない分やや効率がよく、比較も高速。
- 文字の意味がはっきりするのでコードが読みやすくなる
- immutable なので内容を書き換えられる心配がない
大抵のメソッドはシンボルの代わりに文字列を引数として渡すこともできるようになっています。
Symbol クラスのメソッドには、String クラスのメソッドと同名で似た働きをするものもあります。
特異メソッド
all_symbols -> [Symbol]
-
定義済みの全てのシンボルオブジェクトの配列を返します。
p Symbol.all_symbols #=> [:RUBY_PLATFORM, :RUBY_VERSION, ...]
リテラルで表記したシンボルのうち、コンパイル時に値が決まるものはその時に生成されます。 それ以外の式展開を含むリテラルや、メソッドで表記されたものは式の評価時に生成されます。 (何にも使われないシンボルは最適化により生成されないことがあります)
def number 'make_3' end p Symbol.all_symbols.select{|sym|sym.to_s.include? 'make'} #=> [:make_1, :make_2] re = #確実に生成されるように代入操作を行う :make_1, :'make_2', :"#{number}", 'make_4'.intern p Symbol.all_symbols.select{|sym|sym.to_s.include? 'make'} #=> [:make_1, :make_2, :make_3, :make_4]
インスタンスメソッド
self < other -> bool
-
比較演算子 <=> をもとにオブジェクト同士を比較します。 <=> が負の整数を返した場合に、true を返します。 それ以外の整数を返した場合に、false を返します。
- [PARAM] other:
- 自身と比較したいオブジェクトを指定します。
- [EXCEPTION] ArgumentError:
- <=> が nil を返したときに発生します。
self <= other -> bool
-
比較演算子 <=> をもとにオブジェクト同士を比較します。 <=> が負の整数か 0 を返した場合に、true を返します。 それ以外の整数を返した場合に、false を返します。
- [PARAM] other:
- 自身と比較したいオブジェクトを指定します。
- [EXCEPTION] ArgumentError:
- <=> が nil を返したときに発生します。
self <=> other -> -1 | 0 | 1
-
self と other のシンボルに対応する文字列を ASCII コード順で比較して、 self が大きい時には正の整数、等しい時には 0、小さい時には負の整数を返し ます。
- [PARAM] other:
- 比較対象のシンボルを指定します。
p :aaa <=> :xxx # => -1 p :aaa <=> :aaa # => 0 p :xxx <=> :aaa # => 1
[SEE_ALSO] String#<=>
self == other -> true | false
-
other が同じシンボルの時に真を返します。 そうでない場合は偽を返します。
- [PARAM] other:
- 比較対象のシンボルを指定します。
self == other -> bool | nil
-
比較演算子 <=> をもとにオブジェクト同士を比較します。 <=> が 0 を返した時に、true を返します。 それ以外を返した場合は、false を返します。
- [PARAM] other:
- 自身と比較したいオブジェクトを指定します。
self =~ other -> Integer | nil
match(other) -> Integer | nil
-
正規表現 other とのマッチを行います。
(self.to_s =~ other と同じです。)
- [PARAM] other:
- 比較対象のシンボルを指定します。
- [RETURN]
- マッチが成功すればマッチした位置のインデックスを、そうでなければ nil を返します。
p :foo =~ /foo/ # => 0 p :foobar =~ /bar/ # => 3 p :foo =~ /bar/ # => nil
[SEE_ALSO] String#=~, String#match
self > other -> bool
-
比較演算子 <=> をもとにオブジェクト同士を比較します。 <=> が正の整数を返した場合に、true を返します。 それ以外の整数を返した場合に、false を返します。
- [PARAM] other:
- 自身と比較したいオブジェクトを指定します。
- [EXCEPTION] ArgumentError:
- <=> が nil を返したときに発生します。
self >= other -> bool
-
比較演算子 <=> をもとにオブジェクト同士を比較します。 <=> が正の整数か 0 を返した場合に、true を返します。 それ以外の整数を返した場合に、false を返します。
- [PARAM] other:
- 自身と比較したいオブジェクトを指定します。
- [EXCEPTION] ArgumentError:
- <=> が nil を返したときに発生します。
self[nth] -> String | nil
slice(nth) -> String | nil
-
nth 番目の文字を返します。
(self.to_s[nth] と同じです。)
- [PARAM] nth:
- 文字の位置を表す整数を指定します。
:foo[0] # => "f" :foo[1] # => "o" :foo[2] # => "o"
self[nth, len] -> String | nil
slice(nth, len) -> String | nil
-
nth 番目から長さ len の部分文字列を新しく作って返します。
(self.to_s[nth, len] と同じです。)
- [PARAM] nth:
- 文字の位置を表す整数を指定します。
- [PARAM] len:
- 文字列の長さを指定します。
:foo[1, 2] # => "oo"
self[substr] -> String | nil
slice(substr) -> String | nil
-
self が substr を含む場合、一致した文字列を新しく作って返します。
(self.to_s[substr] と同じです。)
self[regexp, nth = 0] -> String | nil
slice(regexp, nth = 0) -> String | nil
-
正規表現 regexp の nth 番目の括弧にマッチする最初の部分文字列を返します。
(self.to_s[regexp, nth] と同じです。)
- [PARAM] regexp:
- 正規表現を指定します。
- [PARAM] nth:
- 取得したい正規表現レジスタのインデックスを指定します。
:foobar[/bar/] # => "bar" :foobarbaz[/(ba.)(ba.)/, 0] # => "barbaz" :foobarbaz[/(ba.)(ba.)/, 1] # => "bar" :foobarbaz[/(ba.)(ba.)/, 2] # => "baz"
self[range] -> String | nil
slice(range) -> String | nil
-
rangeで指定したインデックスの範囲に含まれる部分文字列を返します。
(self.to_s[range] と同じです。)
- [PARAM] range:
- 取得したい文字列の範囲を示す Range オブジェクトを指定します。
:foo[0..1] # => "fo"
[SEE_ALSO] String#[], String#slice
between?(min, max) -> bool
-
比較演算子 <=> をもとに self が min と max の範囲内(min, max を含みます)にあるかを判断します。
以下のコードと同じです。
self >= min and self <= max
- [PARAM] min:
- 範囲の下端を表すオブジェクトを指定します。
- [PARAM] max:
- 範囲の上端を表すオブジェクトを指定します。
- [EXCEPTION] ArgumentError:
- self <=> min か、self <=> max が nil を返 したときに発生します。
3.between?(1, 5) #=> true 6.between?(1, 5) #=> false 'cat'.between?('ant', 'dog') #=> true 'gnu'.between?('ant', 'dog') #=> false
capitalize -> Symbol
-
シンボルに対応する文字列の先頭の文字を大文字に、残りを小文字に変更した シンボルを返します。
(self.to_s.capitalize.intern と同じです。)
:foobar.capitalize #=> :Foobar :fooBar.capitalize #=> :Foobar :FOOBAR.capitalize #=> :Foobar :"foobar--".capitalize # => "Foobar--"
[SEE_ALSO] String#capitalize
casecmp(other) -> -1 | 0 | 1
-
Symbol#<=> と同様にシンボルに対応する文字列の順序を比較しますが、 アルファベットの大文字小文字の違いを無視します。
- [PARAM] other:
- 比較対象のシンボルを指定します。
p :a <=> :A # => 1 p :a.casecmp(:A) # => 0
[SEE_ALSO] String#casecmp
downcase -> Symbol
-
大文字を小文字に変換したシンボルを返します。
(self.to_s.downcase.intern と同じです。)
:FOO.downcase #=> :foo
[SEE_ALSO] String#downcase
empty? -> bool
-
自身が :"" (length が 0 のシンボル)かどうかを返します。
:"".empty? #=> true :foo.empty? #=> false
[SEE_ALSO] String#empty?
encoding -> Encoding
-
シンボルに対応する文字列のエンコーディング情報を表現した Encoding オブ ジェクトを返します。
[SEE_ALSO] String#encoding
id2name -> String
to_s -> String
-
シンボルに対応する文字列を返します。
逆に、文字列に対応するシンボルを得るには String#intern を使います。
p :foo.id2name # => "foo" p :foo.id2name.intern == :foo # => true
[SEE_ALSO] String#intern
inspect -> String
-
自身を人間に読みやすい文字列にして返します。
:fred.inspect #=> ":fred"
intern -> self
to_sym -> self
-
self を返します。
[SEE_ALSO] String#intern
length -> Integer
size -> Integer
-
シンボルに対応する文字列の長さを返します。
(self.to_s.length と同じです。)
:foo.length #=> 3
[SEE_ALSO] String#length, String#size
succ -> Symbol
next -> Symbol
-
シンボルに対応する文字列の「次の」文字列に対応するシンボルを返します。
(self.to_s.next.intern と同じです。)
:a.next # => :b :foo.next # => :fop
[SEE_ALSO] String#succ
swapcase -> Symbol
-
'A' から 'Z' までのアルファベット大文字を小文字に、'a' から 'z' までの アルファベット小文字を大文字に変更したシンボルを返します。
(self.to_s.swapcase.intern と同じです。)
p :ABCxyz.swapcase # => :abcXYZ p :Access.swapcase # => :aCCESS
[SEE_ALSO] String#swapcase
to_proc -> Proc
-
self に対応する Proc オブジェクトを返します。
生成される Proc オブジェクトを呼びだす(Proc#call)と、 その第一引数の self という名前のメソッドを 残りの引数を渡して呼びだされます。
:to_i.to_proc["ff", 16] # => 255 (1..3).collect(&:to_s) #=> ["1", "2", "3"] (1..3).inject(&:+) #=> 6
upcase -> Symbol
-
小文字を大文字に変換したシンボルを返します。
(self.to_s.upcase.intern と同じです。)
:foo.upcase #=> :FOO
[SEE_ALSO] String#upcase
- Ruby 1.9.3 リファレンスマニュアル
- はじめに
- コマンド
- Rubyの起動
- 環境変数
- Ruby言語仕様
- 組み込みライブラリ
- クラス
- Array
- BasicObject
- Bignum
- Binding
- Class
- Complex
- Data
- Dir
- Encoding
- Encoding::
Converter - Enumerator
- FalseClass
- Fiber
- File
- File::Stat
- Fixnum
- Float
- Hash
- IO
- Integer
- MatchData
- Method
- Module
- Mutex
- NilClass
- Numeric
- Object
- Proc
- Process::Status
- Random
- Range
- Rational
- Regexp
- String
- Struct
- Struct::Tms
- Symbol
- Thread
- ThreadGroup
- Time
- TrueClass
- UnboundMethod
- モジュール
- オブジェクト
- 例外クラス
- 組み込み関数
(Kernelモジュール関数) - 組み込み定数
(Kernel定数) - 組み込み特殊変数
- クラス
- 標準添付ライブラリ
- pack テンプレート文字列
- sprintf フォーマット
- Ruby用語集
- Rubyで使われる記号の意味
- 疑似BNFによるRubyの文法
- バージョン情報 / このリファレンスについて