上級

coerce未実装のクラスと数値を演算すると TypeError になる

自作クラスのインスタンスを 数値 + 自作オブジェクト の順で演算すると、Integer側の+が呼ばれます。Integerは自作クラスの値をどう数値として扱えばよいか分からないため、そのクラスにcoerceメソッドが定義されていない限りTypeErrorになります。

エラーメッセージの読み方

main.rb:11:in `+': Money can't be coerced into Integer (TypeError)

main.rb

ファイル名

11

行番号 — 実際にクラッシュした行

+

発生場所 — <main> ならトップレベル、メソッド名ならそのメソッドの中

TypeError

例外クラス — 何が起きたか。ここを検索するのが最短です

Money can't be coerced into Integer

詳細メッセージ — どの値が問題だったか

このエラーが出る典型パターン

 1  class Money
 2    attr_reader :amount
 3    def initialize(amount)
 4      @amount = amount
 5    end
 6    def +(other)
 7      Money.new(amount + other.amount)
 8    end
 9  end
10  
11  total = 5 + Money.new(50)           
                          ^
12  puts total.amount

 1  class Weight
 2    attr_reader :grams
 3    def initialize(grams)
 4      @grams = grams
 5    end
 6    def +(other)
 7      Weight.new(grams + other.grams)
 8    end
 9  end
10  
11  total = 5 + Weight.new(50)            
                           ^
12  puts total.grams

 1  class Length
 2    attr_reader :cm
 3    def initialize(cm)
 4      @cm = cm
 5    end
 6    def +(other)
 7      Length.new(cm + other.cm)
 8    end
 9  end
10  
11  total = 5 + Length.new(50)            
                           ^
12  puts total.cm

 1  class Volume
 2    attr_reader :ml
 3    def initialize(ml)
 4      @ml = ml
 5    end
 6    def +(other)
 7      Volume.new(ml + other.ml)
 8    end
 9  end
10  
11  total = 5 + Volume.new(50)            
                           ^
12  puts total.ml

 1  class Score
 2    attr_reader :points
 3    def initialize(points)
 4      @points = points
 5    end
 6    def +(other)
 7      Score.new(points + other.points)
 8    end
 9  end
10  
11  total = 5 + Score.new(50)           
                          ^
12  puts total.points

よくある誤解

「自作クラスに+を定義しておけば、数値を左に置いた演算でもそれが呼ばれるはず」という思い込みは誤りです。演算子は左側のオブジェクトのメソッドが優先されるため、数値を左に置いた場合は自作クラス側ではなくInteger側の+が呼ばれ、coerceによる変換手順を用意しない限り失敗します。

実務での勘所

coerceが解決の鍵になるのは、Integerの+が、認識できない相手を渡された最後の手段として、その相手のcoerceメソッドを呼び出す設計になっているためです。自作クラスにdef coerce(other); [MyClass.new(other), self]; endのようなメソッドを実装しておくと、Integer側はこれを呼び、返ってきた「両方とも比較可能な形にそろえた2つの値」を使って、あらためて自作クラス同士の+として計算をやり直します。coerceは「私と、あなたを、両方とも同じ土俵で扱えるペアに変換してください」という依頼に応える窓口です。

演習をはじめる

関連するエラー

• Comparable を include しても <=> が無いと比較演算子は使えないComparableモジュールをincludeするだけでは <、>、between? などのメソッドは動きません。
• 文字列と数値を + で連結すると TypeError になるRubyの+演算子は文字列同士、数値同士でしか使えません。