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

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

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

作成日: 更新日:

基本的な使い方

optionsメソッドは、正規表現オブジェクトに設定されているオプションフラグの整数値を取得するメソッドです。正規表現は、特定の文字列パターンを見つけるために使われますが、そのマッチングの挙動は様々なオプションによって制御されます。例えば、大文字と小文字を区別するかどうか、文字列全体ではなく複数行にわたってマッチングを行うかどうかなどがオプションとして設定可能です。

このメソッドが返す整数値は、正規表現オブジェクトが作成された際に指定されたすべてのオプションをまとめたものです。もし複数のオプションが設定されていた場合、それらのオプションを表す定数(例えばRegexp::IGNORECASEは大文字・小文字を区別しない設定、Regexp::MULTILINEは複数行モードの設定などを意味します)の値をビットOR演算で結合した結果が返されます。これにより、一つの整数値で複数のオプションの状態を表現しています。

optionsメソッドを使用することで、既存の正規表現オブジェクトがどのような振る舞いをするように設定されているかをプログラムから確認できます。例えば、ある正規表現オブジェクトが、大文字・小文字を無視してマッチングする設定になっているかを後から調べたい場合に役立ちます。この情報は、正規表現の挙動に応じてプログラムの処理を動的に変更したり、デバッグを行う際に正規表現の設定状態を検証したりする場面で活用できます。

構文(syntax)

1/pattern/i.options

引数(parameters)

引数なし

引数はありません

戻り値(return)

Integer

Regexpオブジェクトに設定されているオプションを整数で返します。

関連コンテンツ