【JSリファレンス】String.prototype.match()

更新日:2024/06/14

String.prototype.match()は、Stringオブジェクト(Stringコンストラクターのインスタンス)プロトタイプチェーンに組み込まれるメソッドです。

引数としてRegExpオブジェクトを受け取り、対象の文字列に正規表現を適用した結果を返します。

 

■構文

String.prototype.match ( regexp )
  1. regexp: 文字列に適用する値

    次の3つのうちのどれかを指定

    RegExpオブジェクト
    正規表現文字列(開始と終了の / は含まない)
    [Symbol.match]をプロパティ名にもつオブジェクト

正規表現文字列は、RegExpオブジェクトに変換されます。

正規表現のマッチング処理の本体は、RegExpオブジェクトの[Symbol.match]()メソッドです。
このメソッドは、String.prototype.match( )によって呼び出されます。

実際にはRegExpオブジェクトである必要はなく、[Symbol.match]をプロパティ名を持っていれば他のオブジェクトでも呼び出されます。

String.prototype.match( )は、[Symbol.match]()の戻り値をそのまま返します。
そのため、戻り値は[Symbol.match]()に依存します。

引数がRegExpオブジェクトの場合

  • 正規表現にgフラグがない場合は、マッチした文字列とキャプチャグループの配列、およびいくつかのプロパティ(使用例参照)
  • 正規表現にgフラグがある場合は、全てのマッチ文字列の配列(キャプチャグループを含まない)

引数がRegExpオブジェクトでない場合

 

■使用例

▶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

書いた人(管理人):けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない?」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。