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

【JavaScript ECMAScript】RegExp::RegExp.prototype[Symbol.match]インスタンスメソッドの使い方

RegExp.prototype[Symbol.match]()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

RegExp.prototypeSymbol.matchメソッドは、正規表現オブジェクトが文字列に対してどのようにマッチングを行うかを定義し、その結果を取得するメソッドです。このメソッドは、通常、開発者が直接呼び出すものではなく、String.prototype.match()メソッドが正規表現オブジェクトを引数として受け取った際に、その内部で自動的に呼び出されます。

具体的には、ある文字列に対して正規表現でパターンを探す際、String.prototype.match()メソッドは正規表現オブジェクトのRegExp.prototypeSymbol.matchを呼び出し、マッチング処理を実行します。マッチングが成功した場合、このメソッドはマッチした部分文字列やキャプチャグループなどの情報を含む配列を返します。一方、文字列が正規表現パターンに一つもマッチしなかった場合は、nullを返します。

このメソッドは、JavaScriptの強力な機能である正規表現の挙動をカスタマイズするためのシンボルメソッドの一つです。これにより、独自の振る舞いを持つ正規表現ライクなオブジェクトを作成し、String.prototype.match()のような標準メソッドと組み合わせて使用することが可能になります。システムエンジニアを目指す上で、正規表現は文字列処理において非常に重要な役割を果たすツールであり、このメソッドはその基盤となる動作を理解する上で役立ちます。

公式リファレンス: RegExp.prototype[Symbol.match]()

構文(syntax)

1const regex = /pattern/;
2const targetString = "example string with pattern";
3const matchResult = regex[Symbol.match](targetString);

引数(parameters)

string

  • string: マッチング対象の文字列

戻り値(return)

Array または null

String.prototype.match()メソッドのように、正規表現にマッチする結果を配列で返します。マッチしなかった場合はnullを返します。

関連コンテンツ

関連プログラミング言語