search メソッド

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

function search(rgExp : RegExp) : Number

引数

rgExp
必ず指定します。検索に使用する正規表現のパターンと適用できるフラグを格納した Regular Expression オブジェクトのインスタンスです。

解説

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

使用例

search メソッドの使用例を次に示します。

function SearchDemo(){
   var r, re;                   //Declare variables.
   var s = "The rain in Spain falls mainly in the plain.";
   re = /falls/i;               //Create regular expression pattern.
   r = s.search(re);            //Search the string.
   return(r);                   //Return the index to the first match
                                //or –1 if no match is found.
}