search メソッド

正規表現に一致する最初の文字列の位置を返します。

stringObj.search(rgExp) 

引数

  • stringObj
    必ず指定します。検索対象とする String オブジェクトの名前または文字列リテラルを指定します。
  • rgExp
    必ず指定します。正規表現パターンおよび適用できるフラグを含む Regular Expression オブジェクトのインスタンスです。

解説

search メソッドは、パターンに一致する文字列が見つかったかどうかを示します。一致する文字列が見つかった場合、search メソッドは、その文字列が先頭からどれだけ離れているかを示す整数値を返します。一致する文字列が見つからなかった場合は、-1 を返します。

使用例

次のコードは、search メソッドの使用例です。

function SearchDemo(){
   var r, re;                   // 変数を宣言します。
   var s = "The rain in Spain falls mainly in the plain.";
   re = /falls/i;               // 正規表現パターンを作成します。
   r = s.search(re);            // 指定された文字列を検索します。
   return(r);                   // ブール値で結果を返します。
}

必要条件

バージョン 3

参照

exec メソッド | match メソッド | Regular Expression オブジェクト | 正規表現の構文 | replace メソッド | String Object メソッド | test メソッド

対象: String オブジェクト