【JSリファレンス】String.prototype.match()
更新日:2024/06/14
String.prototype.match()は、Stringオブジェクト(Stringコンストラクターのインスタンス)のプロトタイプチェーンに組み込まれるメソッドです。
引数としてRegExpオブジェクトを受け取り、対象の文字列に正規表現を適用した結果を返します。
■構文
String.prototype.match ( regexp )
- regexp: 文字列に適用する値
次の3つのうちのどれかを指定
●RegExpオブジェクト
●正規表現文字列(開始と終了の / は含まない)
●[Symbol.match]をプロパティ名にもつオブジェクト
正規表現文字列は、RegExpオブジェクトに変換されます。
正規表現のマッチング処理の本体は、RegExpオブジェクトの[Symbol.match]()メソッドです。
このメソッドは、String.prototype.match( )によって呼び出されます。
実際にはRegExpオブジェクトである必要はなく、[Symbol.match]をプロパティ名を持っていれば他のオブジェクトでも呼び出されます。
String.prototype.match( )は、[Symbol.match]()の戻り値をそのまま返します。
そのため、戻り値は[Symbol.match]()に依存します。
- 正規表現にgフラグがない場合は、マッチした文字列とキャプチャグループの配列、およびいくつかのプロパティ(使用例参照)
- 正規表現にgフラグがある場合は、全てのマッチ文字列の配列(キャプチャグループを含まない)
引数がRegExpオブジェクトでない場合
- [Symbol.match]()の戻り値
■使用例
▶gフラグがない場合
const rg = /([a-z]\d)/;
console.log( "a1b2".match( rg ) );
// [ "a1", "a", "1", index: 0, input: "a1b2", groups: undefined ]
▶gフラグがある場合
const rg = /([a-z])(\d)/g;
console.log( "a1b2".match( rg ) );
// [ "a1", "b2" ]
▶RegExpオブジェクトでない場合
const obj = {
[Symbol.match]: function(value) {
return value.indexOf( "a" ) >= 0 ?
"match" : "no match";
}
};
console.log( "abc".match( obj ) ); // "match"
console.log( "def".match( obj ) ); // "no match"
関連ページ
更新日:2024/06/14
スポンサーリンク
記事の内容について
こんにちはけーちゃんです。
説明するのって難しいですね。
「なんか言ってることおかしくない?」
たぶん、こんなご意見あると思います。
裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。
掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。
ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php
このサイトは、リンクフリーです。大歓迎です。