Regex.Matches メソッド

定義

名前空間:
System.Text.RegularExpressions
アセンブリ:
System.dll, System.Text.RegularExpressions.dll
アセンブリ:
netstandard.dll, System.Text.RegularExpressions.dll
アセンブリ:
System.Text.RegularExpressions.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

正規表現のすべての出現箇所を入力文字列で検索し、すべての一致を返します。

オーバーロード

名前 説明
Matches(String, String, RegexOptions, TimeSpan)

指定した一致するオプションとタイムアウト間隔を使用して、指定した正規表現のすべての出現箇所について、指定した入力文字列を検索します。
Matches(String, String, RegexOptions)

指定した一致するオプションを使用して、指定された正規表現のすべての出現箇所について、指定した入力文字列を検索します。
Matches(String, Int32)

指定した入力文字列を検索し、文字列内の指定した開始位置から始まる正規表現のすべての出現箇所を検索します。
Matches(String)

指定した入力文字列を検索して、正規表現のすべての出現箇所を検索します。
Matches(String, String)

指定した正規表現のすべての出現箇所について、指定した入力文字列を検索します。

Matches(String, String, RegexOptions, TimeSpan)

ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs

指定した一致するオプションとタイムアウト間隔を使用して、指定した正規表現のすべての出現箇所について、指定した入力文字列を検索します。

public:
 static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Matches : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.MatchCollection
Public Shared Function Matches (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As MatchCollection

パラメーター

input
String

一致を検索する文字列。

pattern
String

照合する正規表現パターン。

options
RegexOptions

一致するオプションを指定する列挙値のビットごとの組み合わせ。

matchTimeout
TimeSpan

タイムアウト間隔、またはメソッドがタイムアウトしないことを示す InfiniteMatchTimeout 。

返品

MatchCollection

検索によって検出された Match オブジェクトのコレクション。 一致が見つからない場合、メソッドは空のコレクション オブジェクトを返します。

例外

ArgumentException

正規表現解析エラーが発生しました。

ArgumentNullException

input または pattern が null。

ArgumentOutOfRangeException

options は、 RegexOptions 値の有効なビットごとの組み合わせではありません。 または、 matchTimeout が負、ゼロ、または約 24 日を超えています。

注釈

Matches(String, String, RegexOptions, TimeSpan) メソッドは、Match(String, String, RegexOptions, TimeSpan) メソッドに似ていますが、入力文字列内で見つかったすべての一致に関する情報を 1 つの一致ではなく返す点が異なります。

静的 Matches メソッドは、指定された正規表現パターンを使用して Regex オブジェクトを構築し、インスタンス メソッドを呼び出 Matchesのと同じです。

Matches(String, String, RegexOptions, TimeSpan) メソッドは、遅延評価を使用して、返されたMatchCollection オブジェクトを設定します。 CountやCopyTo(Array, Int32)など、このコレクションのメンバーにアクセスすると、コレクションがすぐに設定されます。 遅延評価を利用するには、 foreachを使用してコレクションを反復処理します。

遅延評価のため、 Matches(String, String, RegexOptions, TimeSpan) メソッドを呼び出しても、 RegexMatchTimeoutException 例外はスローされません。 ただし、一致する操作が matchTimeout パラメーターで指定されたタイムアウト間隔を超えると、このメソッドによって返されるMatchCollection オブジェクトに対して操作が実行されると、例外がスローされます。

注意 (呼び出し元)

matchTimeout パラメーターを適切な値 (2 秒など) に設定することをお勧めします。 InfiniteMatchTimeoutを指定してタイムアウトを無効にすると、正規表現エンジンのパフォーマンスが若干向上します。 ただし、タイムアウトは次の条件でのみ無効にする必要があります。

  • 正規表現によって処理される入力が既知の信頼できるソースから派生した場合、または静的テキストで構成されている場合。 これにより、ユーザーによって動的に入力されたテキストが除外されます。

  • 正規表現パターンが十分にテストされ、一致、一致しない、および近い一致が効率的に処理されるようにする場合。

  • 正規表現パターンに、近い一致を処理するときに過剰なバックトラッキングを引き起こすことがわかっている言語要素が含まれている場合。

こちらもご覧ください

適用対象

Matches(String, String, RegexOptions)

ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs

指定した一致するオプションを使用して、指定された正規表現のすべての出現箇所について、指定した入力文字列を検索します。

public:
 static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);
public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);
static member Matches : string * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.MatchCollection
Public Shared Function Matches (input As String, pattern As String, options As RegexOptions) As MatchCollection

パラメーター

input
String

一致を検索する文字列。

pattern
String

照合する正規表現パターン。

options
RegexOptions

一致するオプションを指定する列挙値のビットごとの組み合わせ。

返品

MatchCollection

検索によって検出された Match オブジェクトのコレクション。 一致が見つからない場合、メソッドは空のコレクション オブジェクトを返します。

例外

ArgumentException

正規表現解析エラーが発生しました。

ArgumentNullException

input または pattern が null。

ArgumentOutOfRangeException

options は、 RegexOptions 値の有効なビットごとの組み合わせではありません。

注釈

Matches(String, String, RegexOptions) メソッドは、Match(String, String, RegexOptions) メソッドに似ていますが、入力文字列内で見つかったすべての一致に関する情報を 1 つの一致ではなく返す点が異なります。

静的 Matches メソッドは、指定された正規表現パターンを使用して Regex オブジェクトを構築し、インスタンス メソッドを呼び出 Matchesのと同じです。

Matches(String, String, RegexOptions) メソッドは、遅延評価を使用して、返されたMatchCollection オブジェクトを設定します。 CountやCopyTo(Array, Int32)など、このコレクションのメンバーにアクセスすると、コレクションがすぐに設定されます。 遅延評価を利用するには、 foreachを使用してコレクションを反復処理します。

遅延評価のため、 Matches(String, String, RegexOptions) メソッドを呼び出しても、 RegexMatchTimeoutException 例外はスローされません。 ただし、一致する操作がタイムアウト間隔を超えると、このメソッドによって返される MatchCollection オブジェクトに対して操作が実行されると、例外がスローされます。

注意 (呼び出し元)

このメソッドは、呼び出されるアプリケーション ドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。 アプリケーション ドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる InfiniteMatchTimeout値が使用されます。 複数のパターンの一致を取得するための推奨される静的メソッドは Matches(String, String, RegexOptions, TimeSpan)であり、タイムアウト間隔を設定できます。

こちらもご覧ください

適用対象

Matches(String, Int32)

ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs

指定した入力文字列を検索し、文字列内の指定した開始位置から始まる正規表現のすべての出現箇所を検索します。

public:
 System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, int startat);
public System.Text.RegularExpressions.MatchCollection Matches(string input, int startat);
member this.Matches : string * int -> System.Text.RegularExpressions.MatchCollection
Public Function Matches (input As String, startat As Integer) As MatchCollection

パラメーター

input
String

一致を検索する文字列。

startat
Int32

検索を開始する入力文字列内の文字位置。

返品

MatchCollection

検索によって検出された Match オブジェクトのコレクション。 一致が見つからない場合、メソッドは空のコレクション オブジェクトを返します。

例外

ArgumentNullException

input は nullです。

ArgumentOutOfRangeException

startat が 0 より小さいか、 inputの長さより大きい値です。

注釈

Matches(String, Int32) メソッドは、Match(String, Int32) メソッドに似ていますが、入力文字列内で見つかったすべての一致に関する情報を 1 つの一致ではなく返す点が異なります。

startatの詳細については、Match(String, Int32)の解説を参照してください。

Matches(String, Int32) メソッドは、遅延評価を使用して、返されたMatchCollection オブジェクトを設定します。 CountやCopyTo(Array, Int32)など、このコレクションのメンバーにアクセスすると、コレクションがすぐに設定されます。 遅延評価を利用するには、 foreachを使用してコレクションを反復処理します。

遅延評価のため、 Matches(String, Int32) メソッドを呼び出しても、 RegexMatchTimeoutException 例外はスローされません。 ただし、MatchCollection プロパティがMatchTimeoutされず、一致する操作がタイムアウト間隔を超えると、このメソッドによって返されるInfiniteMatchTimeout オブジェクトに対して操作が実行されると、例外がスローされます。

こちらもご覧ください

適用対象

Matches(String)

ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs

指定した入力文字列を検索して、正規表現のすべての出現箇所を検索します。

public:
 System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input);
public System.Text.RegularExpressions.MatchCollection Matches(string input);
member this.Matches : string -> System.Text.RegularExpressions.MatchCollection
Public Function Matches (input As String) As MatchCollection

パラメーター

input
String

一致を検索する文字列。

返品

MatchCollection

検索によって検出された Match オブジェクトのコレクション。 一致が見つからない場合、メソッドは空のコレクション オブジェクトを返します。

例外

ArgumentNullException

input は nullです。

注釈

Matches(String) メソッドは、Match(String) メソッドに似ていますが、入力文字列内で見つかったすべての一致に関する情報を 1 つの一致ではなく返す点が異なります。 コレクションには一致のみが含まれており、最初の非一致で終了します。

Matches(String) メソッドは、遅延評価を使用して、返されたMatchCollection オブジェクトを設定します。 CountやCopyTo(Array, Int32)など、このコレクションのメンバーにアクセスすると、コレクションがすぐに設定されます。 遅延評価を利用するには、 foreachを使用してコレクションを反復処理します。

遅延評価のため、 Matches(String) メソッドを呼び出しても、 RegexMatchTimeoutException 例外はスローされません。 ただし、MatchCollection プロパティがMatchTimeoutされず、一致する操作がタイムアウト間隔を超えると、このメソッドによって返されるInfiniteMatchTimeout オブジェクトに対して操作が実行されると、例外がスローされます。

こちらもご覧ください

適用対象

Matches(String, String)

ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs
ソース:
Regex.Match.cs

指定した正規表現のすべての出現箇所について、指定した入力文字列を検索します。

public:
 static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern);
public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern);
static member Matches : string * string -> System.Text.RegularExpressions.MatchCollection
Public Shared Function Matches (input As String, pattern As String) As MatchCollection

パラメーター

input
String

一致を検索する文字列。

pattern
String

照合する正規表現パターン。

返品

MatchCollection

検索によって検出された Match オブジェクトのコレクション。 一致が見つからない場合、メソッドは空のコレクション オブジェクトを返します。

例外

ArgumentException

正規表現解析エラーが発生しました。

ArgumentNullException

input または pattern が null。

注釈

Matches(String, String) メソッドは、Match(String, String) メソッドに似ていますが、入力文字列内で見つかったすべての一致に関する情報を 1 つの一致ではなく返す点が異なります。

静的 Matches メソッドは、指定された正規表現パターンを使用して Regex オブジェクトを構築し、インスタンス メソッドを呼び出 Matchesのと同じです。

Matches(String, String) メソッドは、遅延評価を使用して、返されたMatchCollection オブジェクトを設定します。 CountやCopyTo(Array, Int32)など、このコレクションのメンバーにアクセスすると、コレクションがすぐに設定されます。 遅延評価を利用するには、 foreachを使用してコレクションを反復処理します。

遅延評価のため、 Matches(String, String) メソッドを呼び出しても、 RegexMatchTimeoutException 例外はスローされません。 ただし、一致する操作がタイムアウト間隔を超えると、このメソッドによって返される MatchCollection オブジェクトに対して操作が実行されると、例外がスローされます。

注意 (呼び出し元)

このメソッドは、呼び出されるアプリケーション ドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。 アプリケーション ドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる InfiniteMatchTimeout値が使用されます。 複数のパターンの一致を取得するための推奨される静的メソッドは Matches(String, String, RegexOptions, TimeSpan)です。これにより、タイムアウト間隔を指定できます。

こちらもご覧ください

適用対象