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

更新日:2024/06/14

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

文字列を正規表現でマッチングさせ、その位置を返します。

 

■構文

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

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

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

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

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

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

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

引数がRegExpオブジェクトの場合、一致した位置(0から始まるインデックス)。
一致しない場合は、-1。

引数がRegExpオブジェクトでない場合、[Symbol.search]()の戻り値

 

■使用例

console.log( "abcdefg".search(/cde/) ); // 2

更新日:2024/06/14

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

スポンサーリンク

記事の内容について

null

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

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

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

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

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

 

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