Test Method (VBScript) 

Executes a regular expression search against a specified string and returns a Boolean value that indicates if a pattern match was found.

object.Test(string) 

Arguments

• object
  Required. Always the name of a RegExp object.

• string
  Required. The text string upon which the regular expression is executed.

Remarks

The actual pattern for the regular expression search is set using the Pattern property of the RegExp object. The RegExp.Global property has no effect on the Test method.

The Test method returns True if a pattern match is found; False if no match is found.

The following code illustrates the use of the Test method.

Function RegExpTest(patrn, strng)

  Dim regEx, retVal            ' Create variable.

  Set regEx = New RegExp         ' Create regular expression.

  regEx.Pattern = patrn         ' Set pattern.

  regEx.IgnoreCase = False      ' Set case sensitivity.

  retVal = regEx.Test(strng)      ' Execute the search test.

  If retVal Then

    RegExpTest = "One or more matches were found."

  Else

    RegExpTest = "No match was found."

  End If

End Function

MsgBox(RegExpTest("is.", "IS1 is2 IS3 is4"))

Requirements

Version 5

Applies To: Regular Expression (RegExp) Object

See Also

Reference

Execute Method
Replace Method (VBScript)