MatchCollection 클래스

정의

정규식 패턴을 입력 문자열에 반복적으로 적용하여 찾은 성공적인 일치 집합을 나타냅니다.Represents the set of successful matches found by iteratively applying a regular expression pattern to the input string.

public ref class MatchCollection : System::Collections::ICollection
public class MatchCollection : System.Collections.ICollection
[System.Serializable]
public class MatchCollection : System.Collections.ICollection
type MatchCollection = class
    interface ICollection
    interface IEnumerable
Public Class MatchCollection
Implements ICollection
상속
MatchCollection
특성
구현

예제

다음 예제에서는 MatchCollection 클래스를 사용 하 여 Match 인스턴스 집합을 조사 하는 방법을 보여 줍니다.The following example illustrates the use of the MatchCollection class to interrogate a set of Match instances.

#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 jumps 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);   
   }
}
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 jumps over the lazy dog dog.";
        
        // Find matches.
        MatchCollection matches = rx.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found in:\n   {1}", 
                          matches.Count, 
                          text);

        // Report on each match.
        foreach (Match match in matches)
        {
            GroupCollection groups = match.Groups;
            Console.WriteLine("'{0}' repeated at positions {1} and {2}",  
                              groups["word"].Value, 
                              groups[0].Index, 
                              groups[1].Index);
        }
    }
}
// The example produces the following output to the console:
//       3 matches found in:
//          The the quick brown fox  fox jumps over the lazy dog dog.
//       'The' repeated at positions 0 and 4
//       'fox' repeated at positions 20 and 25
//       'dog' repeated at positions 50 and 54
Imports System.Text.RegularExpressions

Public Module Test

    Public Sub Main()
        ' Define a regular expression for repeated words.
        Dim rx As New Regex("\b(?<word>\w+)\s+(\k<word>)\b", _
               RegexOptions.Compiled Or RegexOptions.IgnoreCase)

        ' Define a test string.        
        Dim text As String = "The the quick brown fox  fox jumps over the lazy dog dog."
        
        ' Find matches.
        Dim matches As MatchCollection = rx.Matches(text)

        ' Report the number of matches found.
        Console.WriteLine("{0} matches found in:", matches.Count)
        Console.WriteLine("   {0}", text)

        ' Report on each match.
        For Each match As Match In matches
            Dim groups As GroupCollection = match.Groups
            Console.WriteLine("'{0}' repeated at positions {1} and {2}", _ 
                              groups.Item("word").Value, _
                              groups.Item(0).Index, _
                              groups.Item(1).Index)
        Next
    End Sub
End Module
' The example produces the following output to the console:
'       3 matches found in:
'          The the quick brown fox  fox jumps over the lazy dog dog.
'       'The' repeated at positions 0 and 4
'       'fox' repeated at positions 20 and 25
'       'dog' repeated at positions 50 and 54

설명

컬렉션을 변경할 수 없는 (읽기 전용) 및 공용 생성자가 없습니다.The collection is immutable (read-only) and has no public constructor. Regex.Matches 메서드는 MatchCollection 개체를 반환합니다.The Regex.Matches method returns a MatchCollection object.

컬렉션은 0 개 이상의 System.Text.RegularExpressions.Match 개체를 포함 합니다.The collection contains zero or more System.Text.RegularExpressions.Match objects. 일치가 성공적으로 수행 되 면 입력 문자열에서 찾은 각 일치 항목에 대해 하나의 System.Text.RegularExpressions.Match 개체가 컬렉션에 채워집니다.If the match is successful, the collection is populated with one System.Text.RegularExpressions.Match object for each match found in the input string. 일치가 실패 하면 컬렉션은 System.Text.RegularExpressions.Match 개체를 포함 하지 않고 해당 Count 속성이 0과 같습니다.If the match is unsuccessful, the collection contains no System.Text.RegularExpressions.Match objects, and its Count property equals zero.

정규식 엔진은 특정 입력 문자열에 정규식 패턴을 적용 하는 경우 두 가지 방법 중 하나를 사용 하 여 MatchCollection 개체를 작성 합니다.When applying a regular expression pattern to a particular input string, the regular expression engine uses either of two techniques to build the MatchCollection object:

  • 직접 계산 합니다.Direct evaluation.

    Regex.Matches 메서드에 대 한 특정 호출로 인해 발생 하는 모든 일치 항목으로 MatchCollection 개체가 한 번에 채워집니다.The MatchCollection object is populated all at once, with all matches resulting from a particular call to the Regex.Matches method. 이 기술은 컬렉션의 Count 속성에 액세스할 때 사용 됩니다.This technique is used when the collection's Count property is accessed. 일반적으로 컬렉션을 채우는 비용이 많이 드는 방법 이며 큰 성능 저하가 수반 합니다.It typically is the more expensive method of populating the collection and entails a greater performance hit.

  • 지연 평가 합니다.Lazy evaluation.

    MatchCollection 개체는 일치를 기준으로 필요한 경우에 채워집니다.The MatchCollection object is populated as needed on a match-by-match basis. Regex.Match 메서드를 반복적으로 호출 하 고 컬렉션에 각 일치 항목을 추가 하는 정규식 엔진과 동일 합니다.It is equivalent to the regular expression engine calling the Regex.Match method repeatedly and adding each match to the collection. 이 기법은 GetEnumerator 메서드를 통해 컬렉션에 액세스 하거나 foreach 문 ( C#) 또는 For Each...Next 문 (Visual Basic)을 사용 하 여 액세스할 때 사용 됩니다.This technique is used when the collection is accessed through its GetEnumerator method, or when it is accessed using the foreach statement (in C#) or the For Each...Next statement (in Visual Basic).

컬렉션의 멤버를 반복 하려면 언어에서 제공 하는 컬렉션 반복 구문을 사용 해야 합니다 (예: foreach C# 및 For Each...NextTo iterate through the members of the collection, you should use the collection iteration construct provided by your language (such as foreach in C# and For EachNext Visual Basic)에서 GetEnumerator 메서드에 의해 반환 되는 열거자를 검색 하는 대신in Visual Basic) instead of retrieving the enumerator that is returned by the GetEnumerator method.

속성

Count

일치하는 항목의 개수를 가져옵니다.Gets the number of matches.

IsReadOnly

컬렉션이 읽기 전용인지를 나타내는 값을 가져옵니다.Gets a value that indicates whether the collection is read only.

IsSynchronized

컬렉션에 대한 액세스가 동기화되었는지(스레드로부터 안전한지) 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether access to the collection is synchronized (thread-safe).

Item[Int32]

컬렉션의 개별 멤버를 가져옵니다.Gets an individual member of the collection.

SyncRoot

컬렉션에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.Gets an object that can be used to synchronize access to the collection.

메서드

CopyTo(Array, Int32)

지정된 인덱스에서 시작하여 지정된 배열에 컬렉션의 요소를 모두 복사합니다.Copies all the elements of the collection to the given array starting at the given index.

CopyTo(Match[], Int32)
Equals(Object)

지정한 개체가 현재 개체와 같은지를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetEnumerator()

컬렉션을 반복하는 열거자를 제공합니다.Provides an enumerator that iterates through the collection.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

ICollection.CopyTo(Array, Int32)

컬렉션의 모든 요소를 지정한 배열의 지정한 인덱스에서 시작하는 위치에 복사합니다.Copies all the elements of the collection to the specified array starting at the specified index.

ICollection.IsSynchronized

컬렉션에 대한 액세스가 동기화되었는지(스레드로부터 안전한지) 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether access to the collection is synchronized (thread-safe).

ICollection.SyncRoot

컬렉션에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.Gets an object that can be used to synchronize access to the collection.

ICollection<Match>.Add(Match)
ICollection<Match>.Clear()
ICollection<Match>.Contains(Match)
ICollection<Match>.Remove(Match)
IEnumerable<Match>.GetEnumerator()
IList.Add(Object)
IList.Clear()
IList.Contains(Object)
IList.IndexOf(Object)
IList.Insert(Int32, Object)
IList.IsFixedSize
IList.Item[Int32]
IList.Remove(Object)
IList.RemoveAt(Int32)
IList<Match>.IndexOf(Match)
IList<Match>.Insert(Int32, Match)
IList<Match>.Item[Int32]
IList<Match>.RemoveAt(Int32)

확장 메서드

Cast<TResult>(IEnumerable)

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

쿼리를 병렬화할 수 있도록 합니다.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable로 변환합니다.Converts an IEnumerable to an IQueryable.

적용 대상