Core JavaScript 1.5 Reference:Global Objects:String:search

出典: MDC

目次 1 概要 2 構文 3 パラメータ 4 詳細 5 例 5.1 例: search メソッドの使用

[編集] 概要

正規表現と対象の String オブジェクトの間のマッチを調べるための検索を実行します。

String のメソッド
実装されたバージョン:	JavaScript 1.2
ECMA バージョン:	ECMA-262, Edition 3

[編集] 構文

search(regexp)

[編集] パラメータ

regexp 

正規表現 (RegExp) オブジェクトです。RegExp オブジェクトではないオブジェクト obj が渡された場合、それは new RegExp(obj) を使用することによって RegExp オブジェクトに暗黙的に変換されます。

[編集] 詳細

成功した場合、その文字列内で正規表現が見つかったインデックスを返します。失敗した場合、-1 を返します。

あるパターンが文字列において見つかるかどうかを知りたいとき、search メソッドを使用してください（同様のメソッドとして、 RegExp.test メソッドがあります）。より多くの情報が欲しい場合は、（実行速度が遅くなりますが） match メソッドを使用してください（同様のメソッドとして、RegExp.exec メソッドがあります）。

[編集] 例

[編集] 例: search メソッドの使用

以下の例は、テストが成功したかどうかのメッセージを出力します。

function testinput(re, str){
   if (str.search(re) != -1)
      midstring = "含みます";
   else
      midstring = "含みません";
   document.write (str + " は " + re.source + " を " + midstring);
}