Regex.Match

.NET Framework クラス ライブラリ リファレンス

Regex.Match メソッド (String, String)

指定した入力文字列内で、pattern パラメータで指定された正規表現と一致する対象を検索します。

名前空間: System.Text.RegularExpressions
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Shared Function Match
 ( _
    input As String, _
    pattern As String _
) As Match

Visual Basic (使用法)

Dim input As String
Dim pattern As String
Dim returnValue As Match

returnValue = Regex.Match(input, pattern)

C#

public static Match Match (
    string input,
    string pattern
)

C++

public:
static Match^ Match (
    String^ input, 
    String^ pattern
)

J#

public static Match Match (
    String input, 
    String pattern
)

JScript

public static function Match
 (
    input : String, 
    pattern : String
) : Match

パラメータ

input

一致する対象を検索する文字列。

pattern

一致させる正規表現パターン。

戻り値
正規表現 Match オブジェクト。

解説

静的 Match メソッドは、正規表現パターンを指定して Regex オブジェクトを構築し、インスタンス メソッド Match を呼び出す操作と同じです。この静的メソッドは、Regex オブジェクトを明示的に作成しなくても、正規表現を単独で 1 回だけ使用できるようにする目的で用意されています。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Regex クラス
Regex メンバ
System.Text.RegularExpressions 名前空間

Regex.Match メソッド (String, Int32)

入力文字列内の指定した開始位置から検索を開始し、その入力文字列内で正規表現と一致する対象を 1 つ検索します。

名前空間: System.Text.RegularExpressions
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Match ( _
    input As String, _
    startat As Integer _
) As Match

Visual Basic (使用法)

Dim instance As Regex
Dim input As String
Dim startat As Integer
Dim returnValue As Match

returnValue = instance.Match(input, startat)

C#

public Match Match (
    string input,
    int startat
)

C++

public:
Match^ Match (
    String^ input, 
    int startat
)

J#

public Match Match (
    String input, 
    int startat
)

JScript

public function Match (
    input : String, 
    startat : int
) : Match

パラメータ

input

一致する対象を検索する文字列。

startat

検索を開始する文字の位置。

戻り値
正規表現 Match オブジェクト。

解説

startat パラメータを使用した、文字列内の開始位置の指定は省略できます。開始位置を指定しない場合は、検索は既定の startat 位置から始まります。正規表現が左から右の方向に検索する場合、既定の startat 位置は間隔の先頭になります。左から右の方向に検索する場合は、startat 位置は間隔の末尾になります。

スキャンが行われないように検索の動作を限定する場合は、\G を使用して正規表現を (左から右のパターンでは左、または右から左のパターンでは右に) 固定します。これにより、確実に startpos から検索が開始するようになります。

Regex が左から右 (既定値) の場合、検索およびスキャンは startat で指定した文字から開始し、右方向に進行します。Regex が右から左の場合 (RightToLeft オプションを使用してオブジェクトが構築された場合)、検索およびスキャンは startat -1 の位置の文字から開始し、左方向に進行します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Regex クラス
Regex メンバ
System.Text.RegularExpressions 名前空間

Regex.Match メソッド (String, String, RegexOptions)

options パラメータで一致オプションを指定し、pattern パラメータで指定された正規表現に一致する対象を検索します。

名前空間: System.Text.RegularExpressions
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Shared Function Match
 ( _
    input As String, _
    pattern As String, _
    options As RegexOptions _
) As Match

Visual Basic (使用法)

Dim input As String
Dim pattern As String
Dim options As RegexOptions
Dim returnValue As Match

returnValue = Regex.Match(input, pattern, options)

C#

public static Match Match (
    string input,
    string pattern,
    RegexOptions options
)

C++

public:
static Match^ Match (
    String^ input, 
    String^ pattern, 
    RegexOptions options
)

J#

public static Match Match (
    String input, 
    String pattern, 
    RegexOptions options
)

JScript

public static function Match
 (
    input : String, 
    pattern : String, 
    options : RegexOptions
) : Match

パラメータ

input

一致しているかどうかを調べる対象の文字列。

pattern

一致させる正規表現パターン。

options

ビットごとの OR 演算による RegexOption 列挙値の組み合わせ。

戻り値
正規表現 Match オブジェクト。

解説

スキャンが行われないように検索の動作を限定する場合は、\G を使用して正規表現を (左から右のパターンでは左、または右から左のパターンでは右に) 固定します。これにより、確実に startpos から検索が開始するようになります。

Regex が左から右 (既定値) の場合、検索およびスキャンは startat で指定した文字から開始し、右方向に進行します。Regex が右から左の場合 (RightToLeft オプションを使用してオブジェクトが構築された場合)、検索およびスキャンは startat -1 の位置の文字から開始し、左方向に進行します。

静的 Match メソッドは、パターンを指定して Regex オブジェクトを構築し、インスタンス メソッド Match を呼び出す操作と同じです。この静的メソッドは、Regex オブジェクトを明示的に作成しなくても、正規表現を単独で 1 回だけ使用できるようにする目的で用意されています。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Regex クラス
Regex メンバ
System.Text.RegularExpressions 名前空間

Regex.Match メソッド (String, Int32, Int32)

入力文字列の開始位置および入力文字列長を指定して、その入力文字列内で正規表現と一致する対象を検索します。

名前空間: System.Text.RegularExpressions
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Match ( _
    input As String, _
    beginning As Integer, _
    length As Integer _
) As Match

Visual Basic (使用法)

Dim instance As Regex
Dim input As String
Dim beginning As Integer
Dim length As Integer
Dim returnValue As Match

returnValue = instance.Match(input, beginning, length)

C#

public Match Match (
    string input,
    int beginning,
    int length
)

C++

public:
Match^ Match (
    String^ input, 
    int beginning, 
    int length
)

J#

public Match Match (
    String input, 
    int beginning, 
    int length
)

JScript

public function Match (
    input : String, 
    beginning : int, 
    length : int
) : Match

パラメータ

input

一致しているかどうかを調べる対象の文字列。

beginning

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

length

検索に含める部分文字列の文字数。

戻り値
正規表現 Match オブジェクト。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Regex クラス
Regex メンバ
System.Text.RegularExpressions 名前空間

Regex.Match メソッド

入力文字内で正規表現と一致する対象を 1 つ検索し、その正確な結果を単一の Match オブジェクトとして返します。
オーバーロードの一覧

名前	説明
Regex.Match (String)	指定した入力文字列内で、Regex コンストラクタで指定された正規表現と一致する対象を 1 つ検索します。 .NET Compact Framework によってサポートされています。
Regex.Match (String, Int32)	入力文字列内の指定した開始位置から検索を開始し、その入力文字列内で正規表現と一致する対象を 1 つ検索します。 .NET Compact Framework によってサポートされています。
Regex.Match (String, String)	指定した入力文字列内で、pattern パラメータで指定された正規表現と一致する対象を検索します。 .NET Compact Framework によってサポートされています。
Regex.Match (String, Int32, Int32)	入力文字列の開始位置および入力文字列長を指定して、その入力文字列内で正規表現と一致する対象を検索します。 .NET Compact Framework によってサポートされています。
Regex.Match (String, String, RegexOptions)	options パラメータで一致オプションを指定し、pattern パラメータで指定された正規表現に一致する対象を検索します。 .NET Compact Framework によってサポートされています。

参照

関連項目

Regex クラス
Regex メンバ
System.Text.RegularExpressions 名前空間

Regex.Match メソッド (String)

指定した入力文字列内で、Regex コンストラクタで指定された正規表現と一致する対象を 1 つ検索します。

名前空間: System.Text.RegularExpressions
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function Match ( _
    input As String _
) As Match

Visual Basic (使用法)

Dim instance As Regex
Dim input As String
Dim returnValue As Match

returnValue = instance.Match(input)

C#

public Match Match (
    string input
)

C++

public:
Match^ Match (
    String^ input
)

J#

public Match Match (
    String input
)

JScript

public function Match (
    input : String
) : Match

パラメータ

input

一致する対象を検索する文字列。

戻り値
正規表現 Match オブジェクト。

使用例

正規表現パターンをコンパイルし、文字列から一致するパターンを検索し、一致したグループ、キャプチャ、およびキャプチャ位置を一覧表示するコード例を次に示します。

Visual Basic

Dim text As String = "One
 car red car blue car"
Dim pat As String = "(\w+)\s+(car)"
' Compile the regular expression.
Dim r As Regex = new Regex(pat,
 RegexOptions.IgnoreCase)
' Match the regular expression pattern against a text string.
Dim m As Match = r.Match(text)
Dim matchcount as Integer
 = 0
While (m.Success)
   matchCount += 1
   Console.WriteLine("Match" & (matchCount))
   Dim i As Integer
   For i = 1 to 2
      Dim g as Group = m.Groups(i)
      Console.WriteLine("Group" & i & "='"
 & g.ToString() & "'")
      Dim cc As CaptureCollection = g.Captures
      Dim j As Integer 
      For j = 0 to cc.Count - 1
     Dim c As Capture = cc(j)
         Console.WriteLine("Capture" & j &
 "='" & c.ToString() _
            & "', Position=" & c.Index)
      Next j
   Next i
   m = m.NextMatch()
End While

C#

string text = "One car red car blue car";
string pat = @"(\w+)\s+(car)";
// Compile the regular expression.
Regex r = new Regex(pat, RegexOptions.IgnoreCase);
// Match the regular expression pattern against a text string.
Match m = r.Match(text);
int matchCount = 0;
while (m.Success) 
{
   Console.WriteLine("Match"+ (++matchCount));
   for (int i = 1; i <= 2; i++) 
   {
      Group g = m.Groups[i];
      Console.WriteLine("Group"+i+"='" + g + "'");
      CaptureCollection cc = g.Captures;
      for (int j = 0; j < cc.Count; j++)
 
      {
         Capture c = cc[j];
         System.Console.WriteLine("Capture"+j+"='" + c + "',
 Position="+c.Index);
      }
   }
   m = m.NextMatch();
}

C++

String^ text = "One car red car blue car";
String^ pat = "(\\w+)\\s+(car)";

// Compile the regular expression.
Regex^ r = gcnew Regex( pat,RegexOptions::IgnoreCase );

// Match the regular expression pattern against a text string.
Match^ m = r->Match(text);
int matchCount = 0;
while ( m->Success )
{
   Console::WriteLine( "Match{0}", ++matchCount );
   for ( int i = 1; i <= 2; i++ )
   {
      Group^ g = m->Groups[ i ];
      Console::WriteLine( "Group{0}='{1}'", i, g );
      CaptureCollection^ cc = g->Captures;
      for ( int j = 0; j < cc->Count;
 j++ )
      {
         Capture^ c = cc[ j ];
         System::Console::WriteLine( "Capture{0}='{1}', Position={2}",
 j, c, c->Index );
      }
   }
   m = m->NextMatch();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Regex クラス
Regex メンバ
System.Text.RegularExpressions 名前空間