【Ruby3.x】UnboundMethod::original_name()メソッドの使い方

original_nameメソッドは、UnboundMethodオブジェクトが表すメソッドの、元の名前をSymbolオブジェクトとして取得するメソッドです。

UnboundMethodは、特定のオブジェクトにまだ結びついていない、メソッドの定義そのものを表現する特別なオブジェクトです。これは、あるクラスに定義されているメソッドを、そのクラスのインスタンスやサブクラスのインスタンスに後から紐付けて（バインドして）呼び出すために使われます。

Rubyでは、Module#alias_methodのような機能を使って、既存のメソッドに別の名前（エイリアス）をつけたり、メソッドの定義が上書きされたりすることがあります。このような場合でも、original_nameメソッドを使うことで、そのメソッドが最初にクラスに定義されたときの、本来のメソッド名を正確に知ることができます。例えば、my_methodというメソッドにanother_methodというエイリアスをつけた場合、another_methodから取得したUnboundMethodのoriginal_nameを呼び出すと、元のmy_methodというシンボルが返されます。

このメソッドは、プログラムが自身の構造を調査するリフレクションの機能を利用する際や、デバッグ時にメソッドの本来の役割や起源を特定したい場合に非常に役立ちます。メソッドの定義がどのように変化しても、その根本的な名前を確認できるため、複雑なコードベースの理解を助けるための重要なツールとなります。返される値はRubyのSymbolオブジェクトです。

Copy
1class ExampleClass
2  def original_method; end
3  alias_method :aliased_method, :original_method
4end
5
6ExampleClass.instance_method(:aliased_method).original_name

引数なし

引数はありません

Symbol

UnboundMethod オブジェクトがラップしているメソッドのシンボルを返します。