Regex.IsMatch Method

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> bool

Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Remarks

The IsMatch(String, String, RegexOptions, TimeSpan) method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. To retrieve matched strings, call the Match(String, String, RegexOptions, TimeSpan) or Matches(String, String, RegexOptions, TimeSpan) method instead.

The static IsMatch(String, String, RegexOptions, TimeSpan) method is equivalent to constructing a Regex object with the specified pattern and options and calling the IsMatch(String) instance method. The pattern is cached for rapid retrieval by the regular expression engine.

The matchTimeout parameter specifies how long a pattern matching method should try to find a match before it times out. Setting a time-out interval prevents regular expressions that rely on excessive backtracking from appearing to stop responding when they process input that contains near matches. If no match is found in that time interval, the method throws a RegexMatchTimeoutException exception. matchTimeout overrides any default time-out value defined for the application domain in which the method executes.

Notes to Callers

We recommend that you set the matchTimeout parameter to an appropriate value, such as two seconds. If you disable time-outs by specifying InfiniteMatchTimeout, the regular expression engine offers slightly better performance. However, you should disable time-outs only under the following conditions:

• When the input processed by a regular expression is derived from a known and trusted source or consists of static text. This excludes text that has been dynamically input by users.

• When the regular expression pattern has been thoroughly tested to ensure that it efficiently handles matches, non-matches, and near matches.

• When the regular expression pattern contains no language elements that are known to cause excessive backtracking when processing a near match.

See also

• Regular Expression Language Elements

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> bool

Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions -> bool

Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Remarks

The IsMatch(String, String, RegexOptions) method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. To retrieve matched strings, call the Match(String, String, RegexOptions) or Matches(String, String, RegexOptions) method instead.

The static IsMatch(String, String, RegexOptions) method is equivalent to constructing a Regex object with the specified pattern and options and calling the IsMatch(String) instance method. The pattern is cached for rapid retrieval by the regular expression engine.

Notes to Callers

This method times out after an interval that is equal to the default time-out value of the application domain in which it is called. If a time-out value has not been defined for the application domain, the value InfiniteMatchTimeout, which prevents the method from timing out, is used. The recommended static method for verifying a pattern match is IsMatch(String, String, RegexOptions, TimeSpan), which lets you set the time-out interval.

See also

• Regular Expression Language Elements

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions -> bool

Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static bool IsMatch(System::String ^ input, System::String ^ pattern);

public static bool IsMatch(string input, string pattern);

static member IsMatch : string * string -> bool

Public Shared Function IsMatch (input As String, pattern As String) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Remarks

The IsMatch(String, String) method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. To retrieve matched strings, call the Match(String, String) or Matches(String, String) method instead.

The static IsMatch(String, String) method is equivalent to constructing a Regex object with the specified pattern and calling the IsMatch(String) instance method. The pattern is cached for rapid retrieval by the regular expression engine.

Notes to Callers

This method times out after an interval that is equal to the default time-out value of the application domain in which the method is called. If a time-out value has not been defined for the application domain, the value InfiniteMatchTimeout, which prevents the method from timing out, is used. The recommended static method for verifying a pattern match is IsMatch(String, String, RegexOptions, TimeSpan), which lets you set the time-out interval.

See also

• Regular Expression Language Elements

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 bool IsMatch(ReadOnlySpan<char> input, int startat);

public bool IsMatch(ReadOnlySpan<char> input, int startat);

member this.IsMatch : ReadOnlySpan<char> * int -> bool

Public Function IsMatch (input As ReadOnlySpan(Of Char), startat As Integer) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern);

public static bool IsMatch(ReadOnlySpan<char> input, string pattern);

static member IsMatch : ReadOnlySpan<char> * string -> bool

Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 bool IsMatch(System::String ^ input, int startat);

public bool IsMatch(string input, int startat);

member this.IsMatch : string * int -> bool

Public Function IsMatch (input As String, startat As Integer) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Remarks

The IsMatch(String, Int32) method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. To retrieve matched strings, call the Match(String, Int32) or Matches(String, Int32) method instead.

For more details about startat, see the remarks for Match(String, Int32).

See also

• Regular Expression Language Elements

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 bool IsMatch(System::String ^ input);

public bool IsMatch(string input);

member this.IsMatch : string -> bool

Public Function IsMatch (input As String) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions

Remarks

The IsMatch(String) method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. To determine whether one or more strings match a regular expression pattern and retrieve them for subsequent manipulation, call the Match(String) or Matches(String) method.

The RegexMatchTimeoutException exception is thrown if the execution time of the matching operation exceeds the time-out interval specified by the Regex(String, RegexOptions, TimeSpan) constructor. If you do not set a time-out interval when you call the constructor, the exception is thrown if the operation exceeds any time-out value established for the application domain in which the Regex object is created. If no time-out is defined in the Regex constructor call or in the application domain's properties, or if the time-out value is InfiniteMatchTimeout, no exception is thrown.

See also

• Regular Expression Language Elements

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 bool IsMatch(ReadOnlySpan<char> input);

public bool IsMatch(ReadOnlySpan<char> input);

member this.IsMatch : ReadOnlySpan<char> -> bool

Public Function IsMatch (input As ReadOnlySpan(Of Char)) As Boolean

Parameters

Returns

true if the regular expression finds a match; otherwise, false.

Exceptions