Test メソッド

指定された文字列を正規表現で検索し、パターンに一致する文字列が検索されたかどうかを示すブール (Boolean) 値を返します。

object.Test(string) 

引数

  • object
    必ず指定します。RegExp オブジェクトの名前を指定します。
  • string
    必ず指定します。正規表現による検索の対象となるテキスト文字列を指定します。

解説

正規表現による検索の実際のパターンは、RegExp オブジェクトの Pattern プロパティを使って設定されます。RegExp.Global プロパティは、Test メソッドに影響しません。

Test メソッドは、パターンに一致する文字列が見つかると True、見つからないと False を返します。

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

Function RegExpTest(patrn, strng)
Dim regEx, retVal              ' 変数を作成します。
Set regEx = New RegExp          ' 正規表現を作成します。
regEx.Pattern = patrn          ' パターンを設定します。
regEx.IgnoreCase = False        ' 大文字と小文字を区別するように設定します。
retVal = regEx.Test(strng)      ' 検索をテストします。
  If retVal Then
RegExpTest = "一致する文字列が 1 つ以上見つかりました。"
  Else
RegExpTest = "一致する文字列が見つかりません。"
  End If
End Function
MsgBox(RegExpTest("is.", "IS1 is2 IS3 is4"))

必要条件

バージョン 5

参照

Execute メソッド | Replace メソッド

対象: RegExp オブジェクト