MatchCollection

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

MatchCollection クラス

正規表現パターンを入力文字列に繰り返し適用したときに、パターンに一致した一連の対象を表します。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public Class MatchCollection
    Implements ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As MatchCollection

C#

[SerializableAttribute] 
public class MatchCollection : ICollection,
 IEnumerable

C++

[SerializableAttribute] 
public ref class MatchCollection : ICollection,
 IEnumerable

J#

/** @attribute SerializableAttribute() */ 
public class MatchCollection implements ICollection,
 IEnumerable

JScript

SerializableAttribute 
public class MatchCollection implements ICollection,
 IEnumerable

解説

このコレクションは変更不可 (読み取り専用) で、パブリック コンストラクタはありません。インスタンスは Matches メソッドを通じて返されます。

使用例

MatchCollection クラスを使用し、Match インスタンスのセットを問い合わせるコード例を次に示します。

C#

using System;
using System.Text.RegularExpressions;

public class Test
{

    public static void Main
 ()
    {

        // Define a regular expression for repeated words.
        Regex rx = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b"
,
          RegexOptions.Compiled | RegexOptions.IgnoreCase);

        // Define a test string.        
        string text = "The the quick brown fox  fox jumped
 over the lazy dog dog.";
        
        // Find matches.
        MatchCollection matches = rx.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found.", matches.Count);

        // Report on each match.
        foreach (Match match in matches)
        {
            string word = match.Groups["word"].Value;
            int index = match.Index;
            Console.WriteLine("{0} repeated at position {1}", word, index);
   
        }
        
    }
    
}

C++

#using <System.dll>

using namespace System;
using namespace System::Text::RegularExpressions;
int main()
{
   // Define a regular expression for repeated words.
   Regex^ rx = gcnew Regex( "\\b(?<word>\\w+)\\s+(\\k<word>)\\b",static_cast<RegexOptions>(RegexOptions::Compiled
 | RegexOptions::IgnoreCase) );

   // Define a test string.        
   String^ text = "The the quick brown fox  fox jumped over the lazy dog dog.";

   // Find matches.
   MatchCollection^ matches = rx->Matches( text );

   // Report the number of matches found.
   Console::WriteLine( "{0} matches found.", matches->Count );

   // Report on each match.
   for each (Match^ match in matches)
   {
      String^ word = match->Groups["word"]->Value;
      int index = match->Index;
      Console::WriteLine("{0} repeated at position {1}", word, index);
   
   }
}

J#

import System.*;
import System.Text.RegularExpressions.*;

public class Test
{
    public static void main(String[]
 args)
    {
        // Define a regular expression for repeated words.
        Regex rx = new Regex("\\b(?<word>\\w+)\\s+(\\k<word>)\\b",
 
            RegexOptions.Compiled | RegexOptions.IgnoreCase);

        // Define a test string.        
        String text = "The the quick brown fox  fox jumped over the "
            + "lazy dog dog.";

        // Find matches.
        MatchCollection matches = rx.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found.", (Int32)matches.get_Count());

        // Report on each match.
        for (int iCtr = 0; iCtr < matches.get_Count();
 iCtr++) {
            Match match = matches.get_Item(iCtr);
            String word = match.get_Groups().get_Item("word").get_Value();
            int index = match.get_Index();
            Console.WriteLine("{0} repeated at position {1}", word, 
                (Int32)index);
        }
    } //main       
} //Test

継承階層

System.Object
  System.Text.RegularExpressions.MatchCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
MatchCollection メンバ
System.Text.RegularExpressions 名前空間

MatchCollection プロパティ

パブリック プロパティ

	名前	説明
	SyncRoot	コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。

参照

関連項目

MatchCollection クラス
System.Text.RegularExpressions 名前空間

MatchCollection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CopyTo	指定したインデックスを開始位置として、指定した配列にコレクションのすべての要素をコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	Item[i] と同じ順序で列挙子を提供します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

MatchCollection クラス
System.Text.RegularExpressions 名前空間

MatchCollection メンバ

正規表現パターンを入力文字列に繰り返し適用したときに、パターンに一致した一連の対象を表します。

MatchCollection データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	SyncRoot	コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CopyTo	指定したインデックスを開始位置として、指定した配列にコレクションのすべての要素をコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	Item[i] と同じ順序で列挙子を提供します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

MatchCollection クラス
System.Text.RegularExpressions 名前空間