【Ruby3.x】RubyVM::AbstractSyntaxTree::Location::first_lineno()メソッドの使い方

first_linenoメソッドは、RubyVM::AbstractSyntaxTree::Locationクラスのインスタンスが表すソースコード上の位置情報の中から、その範囲の開始行番号を取得するメソッドです。

RubyVM::AbstractSyntaxTreeモジュールは、Rubyのソースコードを解析して、プログラムの構造を抽象構文木（AST）というデータ構造に変換するための機能を提供しています。このASTは、コンピュータがプログラムの構造を理解しやすくするための木構造の表現です。

RubyVM::AbstractSyntaxTree::Locationクラスは、このASTにおける各ノードが元のソースコードのどの部分に対応しているか、すなわちファイルパス、開始行番号、開始列番号、終了行番号、終了列番号といった詳細な位置情報を持つオブジェクトです。

このfirst_linenoメソッドをLocationオブジェクトに対して呼び出すと、そのオブジェクトが示すコードブロックや式が始まる行番号を整数値として取得できます。この情報は、例えばコードの品質をチェックするリンターや、プログラムの誤りを見つけるデバッガといったツールで活用されます。これらのツールは、エラーや警告がソースコードのどの行で発生したかをユーザーに正確に伝えるために、first_linenoメソッドによって得られる開始行番号を利用します。プログラムの解析やデバッグ作業において、コード上の正確な位置を特定するために不可欠な情報を提供するメソッドです。

Copy
1require 'rubyvm/abstract_syntax_tree'
2
3ast = RubyVM::AbstractSyntaxTree.parse("puts 'Hello'")
4location = ast.location
5line_number = location.first_lineno

引数なし

引数はありません

Integer

RubyVM::AbstractSyntaxTree::Location#first_lineno は、このLocationオブジェクトが表すコード断片の開始行番号を整数で返します。