Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

instance_evalメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

instance_evalメソッドは、レシーバであるオブジェクトの内部(コンテキスト)で、与えられた文字列またはブロックを評価(実行)するメソッドです。

このメソッドが呼び出されると、レシーバのオブジェクトが一時的にselfとなります。これにより、評価されるコードはまるでそのオブジェクト自身の内部で実行されているかのように振る舞います。具体的には、通常は外部から直接アクセスできないレシーバのプライベートメソッドや、インスタンス変数にアクセスし、操作することが可能になります。

引数として文字列を渡した場合、その文字列がRubyのコードとして解釈され、レシーバのコンテキストで実行されます。一方、ブロックを渡した場合、そのブロックがレシーバをselfとして実行されます。このブロックが受け取る引数は、instance_evalメソッドを呼び出した元のスコープから引き継がれます。

このメソッドは、主にオブジェクトの内部状態に一時的にアクセスする必要がある場合や、特定のオブジェクトの振る舞いを動的に変更・拡張するような、いわゆるメタプログラミングの場面で利用されます。例えば、プログラミング言語のような表現力を持つ設定ファイル(ドメイン固有言語、DSL)を作成する際に役立ちます。

ただし、instance_evalは非常に強力な機能であり、オブジェクトの内部構造を外部に露出させるため、カプセル化(オブジェクトの内部を隠蔽する原則)を損なう可能性があります。特に、外部からの信頼できない入力に基づいて文字列を評価する際には、セキュリティ上のリスク(例えば、悪意のあるコードの実行)が生じる可能性があるため、利用には十分な理解と慎重な設計が求められます。

構文(syntax)

1class MyClass
2  def initialize
3    @data = "original"
4  end
5end
6
7obj = MyClass.new
8
9obj.instance_eval do
10  @data = "modified"
11  puts @data
12end

引数(parameters)

string, filename = "(eval)", lineno = 1

  • string: Rubyのコードが記述された文字列。このコードは、レシーバーオブジェクトのコンテキストで評価されます。
  • filename: (eval) = "(eval)": 評価されるコードのソースファイル名。デバッグやエラー報告に使用されます。
  • lineno: 1 = 1: 評価されるコードの行番号。デバッグやエラー報告に使用されます。

戻り値(return)

Object

指定されたブロック内のコードを実行した結果を返します。

関連コンテンツ