Ruby 3.4 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > RubyVM::AbstractSyntaxTreeモジュール > parse

singleton method RubyVM::AbstractSyntaxTree.parse

parse(string) -> RubyVM::AbstractSyntaxTree::Node[permalink][rdoc]

parse(string, keep_script_lines: false, error_tolerant: false, keep_tokens: false) -> RubyVM::AbstractSyntaxTree::Node

文字列を抽象構文木にパースし、その木の根ノードを返します。

[PARAM] string:

パースする対象の Ruby のコードを文字列で指定します。

[PARAM] keep_script_lines:

true を指定すると、 Node#script_lines でノードと関連づけられたソースコードのテキストを取得できます。

[PARAM] keep_tokens:

true を指定すると、 Node#token が利用できます。

[PARAM] error_tolerant:

true を指定すると、構文エラーが発生した際にエラー箇所を type が :ERROR であるようなノードに置き換えてツリーを生成します。

[EXCEPTION] SyntaxError:

string が Ruby のコードとして正しくない場合に発生します。

pp RubyVM::AbstractSyntaxTree.parse("x = 1 + 2")
# => (SCOPE@1:0-1:9
#     tbl: [:x]
#     args: nil
#     body:
#       (LASGN@1:0-1:9 :x
#          (OPCALL@1:4-1:9 (LIT@1:4-1:5 1) :+ (LIST@1:8-1:9 (LIT@1:8-1:9 2) nil))))
pp RubyVM::AbstractSyntaxTree.parse("x = 1; p(x; y=2", error_tolerant: true)
# =>  (SCOPE@1:0-1:15
#      tbl: [:x, :y]
#      args: nil
#      body: (BLOCK@1:0-1:15 (LASGN@1:0-1:5 :x (LIT@1:4-1:5 1)) (ERROR@1:7-1:11) (LASGN@1:12-1:15 :y (LIT@1:14-1:15 2))))