GroupCollection.CopyTo Method

Definition

Namespace:

System.Text.RegularExpressions

Assemblies:

netstandard.dll, System.Text.RegularExpressions.dll

Overloads

CopyTo(Array, Int32)	Copies all the elements of the collection to the given array beginning at the given index.
CopyTo(Group[], Int32)	Copies the elements of the group collection to a Group array, starting at a particular array index.

CopyTo(Array, Int32)

Source:

GroupCollection.cs

Copies all the elements of the collection to the given array beginning at the given index.

C#

public void CopyTo(Array array, int arrayIndex);

Parameters

array

Array

The array the collection is to be copied into.

arrayIndex

Int32

The position in the destination array where the copying is to begin.

Implements

CopyTo(Array, Int32)

Exceptions

ArgumentNullException

array is null.

IndexOutOfRangeException

arrayIndex is outside the bounds of array.

-or-

arrayIndex plus Count is outside the bounds of array.

Examples

The following example extracts each word from a sentence and captures it in a capturing group, The CopyTo method is then used to copy the elements in each match's GroupCollection object to an array that contains the capturing groups from all matches. The individual captured words are then displayed to the console.

C#

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\b(\S+?)\b";
      string input = "This sentence is rather short but pointless.";

      MatchCollection matches = Regex.Matches(input, pattern);
      object[] words = new object[matches.Count * 2];
      
      int index = 0;
      foreach (Match match in matches)
      {
         match.Groups.CopyTo(words, index);
         index += 2;
      }
      
      // Display captured groups.
      for (int ctr = 1; ctr <= words.GetUpperBound(0); ctr += 2)
         Console.WriteLine(words[ctr]);
   }
}
// The example displays the following output:
//       This
//       sentence
//       is
//       rather
//       short
//       but
//       pointless

The regular expression is defined as follows:

Pattern	Description
\b	Match a word boundary.
(\S+?)	Match one or more non-white space characters. Assign them to the first capturing group.
\b	Match a word boundary.

Remarks

Because the entire collection is copied into the array starting at the given index, the destination array must be at least as large as the collection.

Warning

This member is not present in the Portable Class Library. If you are developing applications that target the Portable Class Library, use the GroupCollection.ICollection.CopyTo method instead.

CopyTo(Group[], Int32)

Source:

GroupCollection.cs

Copies the elements of the group collection to a Group array, starting at a particular array index.

C#

public void CopyTo(System.Text.RegularExpressions.Group[] array, int arrayIndex);

Parameters

array

Group[]

The one-dimensional array that is the destination of the elements copied from the group collection. The array must have zero-based indexing.

arrayIndex

Int32

The zero-based index in array at which copying begins.

Implements

CopyTo(T[], Int32)

Exceptions

ArgumentNullException

array is null.

ArgumentOutOfRangeException

arrayIndex is less than zero.

-or-

arrayIndex is greater than the length of array.

ArgumentException

The length of array - arrayIndex is less than the group collection count.