class Struct (Ruby 3.1 リファレンスマニュアル)

要約

構造体クラス。Struct.new はこのクラスのサブクラスを新たに生成します。

個々の構造体はサブクラスから Struct.new を使って生成します。個々の構造体サブクラスでは構造体のメンバに対するアクセスメソッドが定義されています。

継承しているメソッド

Enumerableから継承しているメソッド

特異メソッド

new(*args, keyword_init: nil) -> Class[permalink][rdoc][edit]

new(*args, keyword_init: nil) {|subclass| block } -> Class

Struct クラスに新しいサブクラスを作って、それを返します。

サブクラスでは構造体のメンバに対するアクセスメソッドが定義されています。

例

dog = Struct.new("Dog", :name, :age)
fred = dog.new("fred", 5)
fred.age = 6
printf "name:%s age:%d", fred.name, fred.age
#=> "name:fred age:6" を出力します

実装の都合により、クラス名の省略は後づけの機能でした。メンバ名に String を指定できるのは後方互換性のためだと考えた方が良いでしょう。したがって、メンバ名は Symbol で指定するのが無難です。

[PARAM] args:: 構造体を定義するための可変長引数。String または Symbol を指定します。
[PARAM] keyword_init:: true を指定すると、キーワード引数で初期化する構造体を定義します。 Ruby 3.1 では互換性に影響のある使い方をしたときに警告が出るため、従来の挙動を期待する構造体には明示的に false を指定してください。

例

Point = Struct.new(:x, :y, keyword_init: true) # => Point(keyword_init: true)
Point.new(x: 1, y: 2) # => #<struct Point x=1, y=2>
Point.new(x: 1)       # => #<struct Point x=1, y=nil>
Point.new(y: 2)       # => #<struct Point x=nil, y=2>
Point.new(z: 3)       # ArgumentError (unknown keywords: z)

警告が出る例

Point = Struct.new(:x, :y)
Point.new(x: 1, y: 2)   # => #<struct Point x={:x=>1, :y=>2}, y=nil>
                        # warning: Passing only keyword arguments to Struct#initialize will behave differently from Ruby 3.2. Please use a Hash literal like .new({k: v}) instead of .new(k: v).

# keyword_init: falseを指定すると警告は出ない
Point2 = Struct.new(:x, :y, keyword_init: false)
Point2.new(x: 1, y: 2)  # => #<struct Point2 x={:x=>1, :y=>2}, y=nil>

第一引数が String の場合

args[0] が String の場合、クラス名になるので、大文字で始まる必要があります。つまり、以下のような指定はエラーになります。

例

p Struct.new('foo', 'bar')
# => -:1:in `new': identifier foo needs to be constant (NameError)

また args[1..-1] は、Symbol か String で指定します。

例

p Struct.new("Foo", :foo, :bar)   # => Struct::Foo

第一引数が Symbol の場合

args[0] が Symbol の場合、生成した構造体クラスは名前の無いクラスになります。名前の無いクラスは最初に名前を求める際に代入されている定数名を検索し、見つかった定数名をクラス名とします。

例

Foo = Struct.new(:foo, :bar)
p Foo                             # => Foo

ブロックを指定した場合

Struct.new にブロックを指定した場合は定義した Struct をコンテキストにブロックを評価します。また、定義した Struct はブロックパラメータにも渡されます。

例

Customer = Struct.new(:name, :address) do
  def greeting
    "Hello #{name}!"
  end
end
Customer.new("Dave", "123 Main").greeting # => "Hello Dave!"

Structをカスタマイズする場合はこの方法が推奨されます。無名クラスのサブクラスを作成する方法でカスタマイズする場合は無名クラスが使用されなくなってしまうことがあるためです。

[SEE_ALSO] Class.new

new(*args) -> Struct[permalink][rdoc][edit]

self[*args] -> Struct

(このメソッドは Struct の下位クラスにのみ定義されています) 構造体オブジェクトを生成して返します。

[PARAM] args:: 構造体の初期値を指定します。メンバの初期値は指定されなければ nil です。
[RETURN]: 構造体クラスのインスタンス。
[EXCEPTION] ArgumentError:: 構造体のメンバの数よりも多くの引数を指定した場合に発生します。

例

Foo = Struct.new(:foo, :bar)
foo = Foo.new(1)
p foo.values      # => [1, nil]

keyword_init? -> bool | nil[permalink][rdoc][edit]

(このメソッドは Struct の下位クラスにのみ定義されています) 構造体が作成されたときに keyword_init: true を指定されていたら true を返します。 false を指定されていたら false を返します。それ以外の場合は nil を返します。

例

Foo = Struct.new(:a)
Foo.keyword_init? # => nil
Bar = Struct.new(:a, keyword_init: true)
Bar.keyword_init? # => true
Baz = Struct.new(:a, keyword_init: false)
Baz.keyword_init? # => false

members -> [Symbol][permalink][rdoc][edit]

(このメソッドは Struct の下位クラスにのみ定義されています) 構造体のメンバの名前(Symbol)の配列を返します。

例

Foo = Struct.new(:foo, :bar)
p Foo.members      # => [:foo, :bar]

インスタンスメソッド

self == other -> bool[permalink][rdoc][edit]

self と other のクラスが同じであり、各メンバが == メソッドで比較して等しい場合に true を返します。そうでない場合に false を返します。

[PARAM] other:: self と比較したいオブジェクトを指定します。

例

Dog = Struct.new(:name, :age)
dog1 = Dog.new("fred", 5)
dog2 = Dog.new("fred", 5)

p dog1 == dog2                #=> true
p dog1.eql?(dog2)             #=> true
p dog1.equal?(dog2)           #=> false

[注意] 本メソッドの記述は Struct の下位クラスのインスタンスに対して呼び出す事を想定しています。Struct.new は Struct の下位クラスを作成する点に注意してください。

[SEE_ALSO] Struct#eql?

self[member] -> object[permalink][rdoc][edit]

構造体のメンバの値を返します。

[PARAM] member:: Integer でメンバのインデックスを指定します。 Symbol, String でメンバの名前を指定します。
[EXCEPTION] IndexError:: member が整数で存在しないメンバを指定した場合に発生します。
[EXCEPTION] NameError:: member が String, Symbol で存在しないメンバを指定した場合に発生します。

例

Foo = Struct.new(:foo, :bar)
obj = Foo.new('FOO', 'BAR')
p obj[:foo]     # => "FOO"
p obj['bar']    # => "BAR"
# p obj[:baz]     # => in `[]': no member 'baz' in struct (NameError)
p obj[0]        # => "FOO"
p obj[1]        # => "BAR"
p obj[-1]       # => "BAR"    # Array のように負のインデックスも指定できます。
p obj[2]        # => in `[]': offset 2 too large for struct(size:2) (IndexError)

self[member] = value[permalink][rdoc][edit]

構造体の member で指定されたメンバの値を value にして value を返します。

[PARAM] member:: Integer でメンバのインデックスを指定します。 Symbol, String でメンバの名前を指定します。
[PARAM] value:: メンバに設定する値を指定します。
[EXCEPTION] IndexError:: member が整数で存在しないメンバを指定した場合に発生します。
[EXCEPTION] NameError:: member が String, Symbol で存在しないメンバを指定した場合に発生します。

例

Customer = Struct.new(:name, :address, :zip)
joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)

joe["name"] = "Luke"
joe[:zip]   = "90210"

joe.name   #=> "Luke"
joe.zip    #=> "90210"

values -> [object][permalink][rdoc][edit]

to_a -> [object]

deconstruct -> [object]

構造体のメンバの値を配列にいれて返します。

例

Customer = Struct.new(:name, :address, :zip)
Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345).to_a
# => ["Joe Smith", "123 Maple, Anytown NC", 12345]

[SEE_ALSO] パターンマッチ/非プリミティブなオブジェクトのマッチ: deconstruct メソッドと deconstruct_keys メソッド

deconstruct_keys(array_of_names) -> Hash[permalink][rdoc][edit]

self のメンバの名前と値の組を Hash で返します。

[PARAM] array_of_names:: 返り値に含めるメンバの名前の配列を指定します。nil の場合は全てのメンバを意味します。

例

Customer = Struct.new(:name, :address, :zip)
joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
h = joe.deconstruct_keys([:zip, :address])
h # => {:zip=>12345, :address=>"123 Maple, Anytown NC"}

# 引数が nil の場合は全てのメンバを返します。
h = joe.deconstruct_keys(nil)
h # => {:name=>"Joseph Smith, Jr.", :address=>"123 Maple, Anytown NC", :zip=>12345}

[SEE_ALSO] パターンマッチ/非プリミティブなオブジェクトのマッチ: deconstruct メソッドと deconstruct_keys メソッド

dig(key, ...) -> object | nil[permalink][rdoc][edit]

self 以下のネストしたオブジェクトを dig メソッドで再帰的に参照して返します。途中のオブジェクトが nil であった場合は nil を返します。

[PARAM] key:: キーを任意個指定します。

例

klass = Struct.new(:a)
o = klass.new(klass.new({b: [1, 2, 3]}))

o.dig(:a, :a, :b, 0)              # => 1
o.dig(:b, 0)                      # => nil

[SEE_ALSO] Array#dig, Hash#dig, OpenStruct#dig

each {|value| ... } -> self[permalink][rdoc][edit]

each -> Enumerator

構造体の各メンバに対して繰り返します。

例

Customer = Struct.new(:name, :address, :zip)
joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
joe.each {|x| puts(x) }

# => Joe Smith
#    123 Maple, Anytown NC
#    12345

each_pair {|member, value| ... } -> self[permalink][rdoc][edit]

each_pair -> Enumerator

構造体のメンバ名(Symbol)と値の組を引数にブロックを繰り返し実行します。

例

Foo = Struct.new(:foo, :bar)
Foo.new('FOO', 'BAR').each_pair {|m, v| p [m,v]}
# => [:foo, "FOO"]
#    [:bar, "BAR"]

eql?(other) -> bool[permalink][rdoc][edit]

self と other のクラスが同じであり、各メンバが eql? メソッドで比較して等しい場合に true を返します。そうでない場合に false を返します。

[PARAM] other:: self と比較したいオブジェクトを指定します。

例

Dog = Struct.new(:name, :age)
dog1 = Dog.new("fred", 5)
dog2 = Dog.new("fred", 5)

p dog1 == dog2                #=> true
p dog1.eql?(dog2)             #=> true
p dog1.equal?(dog2)           #=> false

[SEE_ALSO] Struct#==

equal?(other) -> bool[permalink][rdoc][edit]

指定された other が self 自身である場合のみ真を返します。これは Object クラスで定義されたデフォルトの動作です。

[SEE_ALSO] Struct#eql?, Struct#==

select {|i| ... } -> [object][permalink][rdoc][edit]

select -> Enumerator

filter {|i| ... } -> [object]

filter -> Enumerator

構造体のメンバの値に対してブロックを評価した値が真であった要素を全て含む配列を返します。真になる要素がひとつもなかった場合は空の配列を返します。

ブロックを省略した場合は Enumerator を返します。

例

Lots = Struct.new(:a, :b, :c, :d, :e, :f)
l = Lots.new(11, 22, 33, 44, 55, 66)
l.select {|v| (v % 2).zero? }   #=> [22, 44, 66]

[SEE_ALSO] Enumerable#select

hash -> Integer[permalink][rdoc][edit]

self が保持するメンバのハッシュ値を元にして算出した整数を返します。 self が保持するメンバの値が変化すればこのメソッドが返す値も変化します。

例

Dog = Struct.new(:name, :age)
dog = Dog.new("fred", 5)
p dog.hash                    #=> 7917421
dog.name = "john"
p dog.hash                    #=> -38913223

inspect -> String[permalink][rdoc][edit]

to_s -> String

self の内容を人間に読みやすい文字列にして返します。

例

Customer = Struct.new(:name, :address, :zip)
joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
joe.inspect # => "#<struct Customer name=\"Joe Smith\", address=\"123 Maple, Anytown NC\", zip=12345>"

length -> Integer[permalink][rdoc][edit]

size -> Integer

構造体のメンバの数を返します。

例

Customer = Struct.new(:name, :address, :zip)
joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345)
joe.length   #=> 3

members -> [Symbol][permalink][rdoc][edit]

構造体のメンバの名前(Symbol)の配列を返します。

例

Foo = Struct.new(:foo, :bar)
p Foo.new.members  # => [:foo, :bar]

to_h -> Hash[permalink][rdoc][edit]

to_h {|member, value| block } -> Hash

self のメンバ名(Symbol)と値の組を Hash にして返します。

例

Customer = Struct.new(:name, :address, :zip)
Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345).to_h
# => {:name=>"Joe Smith", :address=>"123 Maple, Anytown NC", :zip=>12345}

ブロックを指定すると各ペアでブロックを呼び出し、その結果をペアとして使います。

ブロック付きの例

Customer = Struct.new(:name, :address, :zip)
Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345).to_h {|member, value|
  [member, value*2]
} # => {:name=>"Joe SmithJoe Smith", :address=>"123 Maple, Anytown NC123 Maple, Anytown NC", :zip=>24690}

values_at(*members) -> [object][permalink][rdoc][edit]

引数で指定されたメンバの値の配列を返します。

[PARAM] members:: Integer か Range でメンバのインデックスを指定します。
[EXCEPTION] IndexError:: member が整数で存在しないメンバを指定した場合に発生します。

例

Foo = Struct.new(:foo, :bar, :baz)
obj = Foo.new('FOO', 'BAR', 'BAZ')
p obj.values_at(0, 1, 2)    # => ["FOO", "BAR", "BAZ"]

要約

目次