Regex.Split メソッド

定義

正規表現の一致箇所によって定義される位置で、入力文字列を部分文字列の配列に分割します。Splits an input string into an array of substrings at the positions defined by a regular expression match.

オーバーロード

Split(String, String, RegexOptions, TimeSpan)

指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。Splits an input string into an array of substrings at the positions defined by a specified regular expression pattern. 追加のパラメーターでは、一致が見つからない場合に一致操作とタイムアウト間隔を変更するオプションを指定します。Additional parameters specify options that modify the matching operation and a time-out interval if no match is found.

Split(String, String, RegexOptions)

指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。Splits an input string into an array of substrings at the positions defined by a specified regular expression pattern. 指定したオプションで、一致操作を変更します。Specified options modify the matching operation.

Split(String, Int32, Int32)

Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。Splits an input string a specified maximum number of times into an array of substrings, at the positions defined by a regular expression specified in the Regex constructor. 正規表現パターンの検索は、入力文字列の指定した文字位置から開始します。The search for the regular expression pattern starts at a specified character position in the input string.

Split(String, Int32)

Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。Splits an input string a specified maximum number of times into an array of substrings, at the positions defined by a regular expression specified in the Regex constructor.

Split(String)

Regex コンストラクターで指定された正規表現パターンによって定義されている位置で入力文字列を分割し、部分文字列の配列に格納します。Splits an input string into an array of substrings at the positions defined by a regular expression pattern specified in the Regex constructor.

Split(String, String)

正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。Splits an input string into an array of substrings at the positions defined by a regular expression pattern.

Split(String, String, RegexOptions, TimeSpan)

指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。Splits an input string into an array of substrings at the positions defined by a specified regular expression pattern. 追加のパラメーターでは、一致が見つからない場合に一致操作とタイムアウト間隔を変更するオプションを指定します。Additional parameters specify options that modify the matching operation and a time-out interval if no match is found.

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static string[] Split (string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Split : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string[]
Public Shared Function Split (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As String()

パラメーター

input
String

分割対象の文字列。The string to split.

pattern
String

一致させる正規表現パターン。The regular expression pattern to match.

options
RegexOptions

一致オプションを指定する列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that provide options for matching.

matchTimeout
TimeSpan

タイムアウト期間、またはメソッドがタイムアウトしないことを示す InfiniteMatchTimeoutA time-out interval, or InfiniteMatchTimeout to indicate that the method should not time out.

戻り値

String[]

文字列配列。A string array.

例外

正規表現の解析エラーが発生しました。A regular expression parsing error occurred.

input または patternnull です。input or pattern is null.

options は、 RegexOptions 値のビットごとの正しい組み合わせではありません。options is not a valid bitwise combination of RegexOptions values.

- または --or- matchTimeout が負の値か、0 か、または約 24 日を超えています。matchTimeout is negative, zero, or greater than approximately 24 days.

タイムアウトが発生しました。A time-out occurred. タイムアウトの詳細については、「解説」をご覧ください。For more information about time-outs, see the Remarks section.

注釈

メソッドはString.Split(Char[])メソッドに似ていますが、 Regex.Splitは、文字セットではなく正規表現によって決定された区切り記号で文字列を分割する点が異なります。 Regex.SplitThe Regex.Split methods are similar to the String.Split(Char[]) method, except that Regex.Split splits the string at a delimiter determined by a regular expression instead of a set of characters. 文字列は、できるだけ多くの回数だけ分割されます。The string is split as many times as possible. 区切り記号が見つからない場合、戻り値には、元inputの文字列を値とする1つの要素が含まれます。If no delimiter is found, the return value contains one element whose value is the original input string.

パラメーター patternは、一致させる文字列をシンボリックに記述する正規表現言語要素で構成されます。The pattern parameter consists of regular expression language elements that symbolically describe the string to match. 正規表現の詳細については、「 .NET Framework 正規表現正規表現言語-クイックリファレンス」を参照してください。For more information about regular expressions, see .NET Framework Regular Expressions and Regular Expression Language - Quick Reference.

重要

静的Splitメソッドの呼び出しで使用されるコンパイル済みの正規表現は、自動的にキャッシュされます。Compiled regular expressions used in calls to static Split methods are automatically cached. コンパイルされた正規表現の有効期間を自分で管理Splitするには、インスタンスメソッドを使用します。To manage the lifetime of compiled regular expressions yourself, use the instance Split methods.

複数の一致が互いに隣接している場合は、空の文字列が配列に挿入されます。If multiple matches are adjacent to one another, an empty string is inserted into the array. たとえば、1つのハイフンに文字列を分割すると、返される配列には、隣接する2つのハイフンが見つかる位置に空の文字列が含まれます。For example, splitting a string on a single hyphen causes the returned array to include an empty string in the position where two adjacent hyphens are found.

入力文字列の先頭または末尾に一致が見つかった場合は、返された配列の先頭または末尾に空の文字列が含まれます。If a match is found at the beginning or the end of the input string, an empty string is included at the beginning or the end of the returned array. 次の例では、正規表現[a-z]+パターンを使用して、大文字または小文字のアルファベット文字で入力文字列を分割します。The following example uses the regular expression pattern [a-z]+ to split an input string on any uppercase or lowercase alphabetic character. 文字列の先頭と末尾が一致するアルファベット文字であるため、返された配列の最初の要素と最後String.Emptyの要素の値はになります。Because the string begins and ends with matching alphabetic characters, the value of the first and last element of the returned array is String.Empty.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "[a-z]+";
      string input = "Abc1234Def5678Ghi9012Jklm";
      string[] result = Regex.Split(input, pattern, 
                                    RegexOptions.IgnoreCase,
                                    TimeSpan.FromMilliseconds(500));
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', '1234', '5678', '9012', ''
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "[a-z]+"
      Dim input As String = "Abc1234Def5678Ghi9012Jklm"
      Dim result() As String = Regex.Split(input, pattern, 
                                           RegexOptions.IgnoreCase,
                                           TimeSpan.FromMilliseconds(500))
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', '1234', '5678', '9012', ''

Regex.Split式でキャプチャのかっこを使用する場合、キャプチャされたテキストは結果の文字列の配列に含まれます。If capturing parentheses are used in a Regex.Split expression, any captured text is included in the resulting string array. たとえば、キャプチャするかっこ内に配置されたハイフンで文字列 "plum" を分割した場合、返される配列にはハイフンを含む文字列要素が含まれます。For example, if you split the string "plum-pear" on a hyphen placed within capturing parentheses, the returned array includes a string element that contains the hyphen.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum-pear";
      string pattern = "(-)";

      string[] substrings = Regex.Split(input, pattern);    // Split on hyphens
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'      
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum-pear"
      Dim pattern As String = "(-)" 
      
      Dim substrings() As String = Regex.Split(input, pattern)    ' Split on hyphens.
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The method writes the following to the console:
'    'plum'
'    '-'
'    'pear'      

ただし、正規表現パターンに複数のキャプチャかっこのセットが含まれている場合、このメソッドの動作は .NET Framework のバージョンによって異なります。However, when the regular expression pattern includes multiple sets of capturing parentheses, the behavior of this method depends on the version of the .NET Framework. .NET Framework 1.0 および1.1 では、キャプチャのかっこの最初のセット内に一致が見つからない場合、キャプチャされた追加のかっこからキャプチャされたテキストは、返される配列には含まれません。In the .NET Framework 1.0 and 1.1, if a match is not found within the first set of capturing parentheses, captured text from additional capturing parentheses is not included in the returned array. .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返された配列に追加されます。Starting with the .NET Framework 2.0, all captured text is also added to the returned array. たとえば、次のコードでは、2組のキャプチャかっこを使用して、日付の区切り文字を含む日付の要素を日付文字列から抽出しています。For example, the following code uses two sets of capturing parentheses to extract the elements of a date, including the date delimiters, from a date string. キャプチャかっこの最初のセットはハイフンをキャプチャし、2番目のセットはスラッシュをキャプチャします。The first set of capturing parentheses captures the hyphen, and the second set captures the forward slash. コード例をコンパイルして .NET Framework 1.0 または1.1 の下で実行すると、スラッシュ文字は除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それが含まれます。If the example code is compiled and run under the .NET Framework 1.0 or 1.1, it excludes the slash characters; if it is compiled and run under the .NET Framework 2.0 or later versions, it includes them.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";

      foreach (string result in Regex.Split(input, pattern)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// In .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// In .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007' 
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      For Each result As String In Regex.Split(input, pattern) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007' 

正規表現が空の文字列と一致する場合Split 、は、すべての場所で空の文字列の区切り記号が見つかるため、文字列を1文字の文字列の配列に分割します。If the regular expression can match the empty string, Split will split the string into an array of single-character strings because the empty string delimiter can be found at every location.

パラメーター matchTimeoutは、パターン一致メソッドがタイムアウトする前に一致を検索する期間を指定します。タイムアウト間隔を設定すると、過度なバックトラッキングに依存している正規表現が、ほぼ一致する入力を処理するときに応答を停止することを防ぎます。The matchTimeout parameter specifies how long a pattern matching method should try to find a match before it times out. Setting a time-out interval prevents regular expressions that rely on excessive backtracking from appearing to stop responding when they process input that contains near matches. 詳細については、「正規表現とバックトラッキングのベストプラクティス」を参照してください。For more information, see Best Practices for Regular Expressions and Backtracking. この期間内に一致するものが見つからない場合、メソッドはRegexMatchTimeoutException例外をスローします。If no match is found in that time interval, the method throws a RegexMatchTimeoutException exception. matchTimeoutメソッドを実行するアプリケーションドメインに対して定義されている既定のタイムアウト値をオーバーライドします。matchTimeout overrides any default time-out value defined for the application domain in which the method executes.

注意 (呼び出し元)

matchTimeoutパラメーターには、2秒などの適切な値を設定することをお勧めします。We recommend that you set the matchTimeout parameter to an appropriate value, such as two seconds. を指定InfiniteMatchTimeoutしてタイムアウトを無効にすると、正規表現エンジンのパフォーマンスが若干向上します。If you disable time-outs by specifying InfiniteMatchTimeout, the regular expression engine offers slightly better performance. ただし、次の条件下でのみタイムアウトを無効にする必要があります。However, you should disable time-outs only under the following conditions: -正規表現によって処理される入力が既知の信頼できるソースから派生した場合、または静的なテキストで構成されている場合。- When the input processed by a regular expression is derived from a known and trusted source or consists of static text. これにより、ユーザーが動的に入力したテキストは除外されます。This excludes text that has been dynamically input by users.

-正規表現パターンが完全にテストされ、一致、一致しない、および近い一致を効率的に処理できるようになった場合。- When the regular expression pattern has been thoroughly tested to ensure that it efficiently handles matches, non-matches, and near matches.

-正規表現パターンに、ほぼ一致を処理するときに過度なバックトラッキングを発生させることがわかっている言語要素が含まれていない場合。- When the regular expression pattern contains no language elements that are known to cause excessive backtracking when processing a near match.

こちらもご覧ください

Split(String, String, RegexOptions)

指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。Splits an input string into an array of substrings at the positions defined by a specified regular expression pattern. 指定したオプションで、一致操作を変更します。Specified options modify the matching operation.

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);
public static string[] Split (string input, string pattern, System.Text.RegularExpressions.RegexOptions options);
static member Split : string * string * System.Text.RegularExpressions.RegexOptions -> string[]
Public Shared Function Split (input As String, pattern As String, options As RegexOptions) As String()

パラメーター

input
String

分割対象の文字列。The string to split.

pattern
String

一致させる正規表現パターン。The regular expression pattern to match.

options
RegexOptions

一致オプションを指定する列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that provide options for matching.

戻り値

String[]

文字列の配列。An array of strings.

例外

正規表現の解析エラーが発生しました。A regular expression parsing error occurred.

input または patternnull です。input or pattern is null.

options は、RegexOptions 値のビットごとの正しい組み合わせではありません。options is not a valid bitwise combination of RegexOptions values.

タイムアウトが発生しました。A time-out occurred. タイムアウトの詳細については、「解説」をご覧ください。For more information about time-outs, see the Remarks section.

注釈

メソッドはString.Split(Char[])メソッドに似ていますが、 Regex.Splitは、文字セットではなく正規表現によって決定された区切り記号で文字列を分割する点が異なります。 Regex.SplitThe Regex.Split methods are similar to the String.Split(Char[]) method, except that Regex.Split splits the string at a delimiter determined by a regular expression instead of a set of characters. 文字列は、できるだけ多くの回数だけ分割されます。The string is split as many times as possible. 区切り記号が見つからない場合、戻り値には、元inputの文字列を値とする1つの要素が含まれます。If no delimiter is found, the return value contains one element whose value is the original input string.

パラメーター patternは、一致させる文字列をシンボリックに記述する正規表現言語要素で構成されます。The pattern parameter consists of regular expression language elements that symbolically describe the string to match. 正規表現の詳細については、「 .NET Framework 正規表現正規表現言語-クイックリファレンス」を参照してください。For more information about regular expressions, see .NET Framework Regular Expressions and Regular Expression Language - Quick Reference.

重要

静的Splitメソッドの呼び出しで使用されるコンパイル済みの正規表現は、自動的にキャッシュされます。Compiled regular expressions used in calls to static Split methods are automatically cached. コンパイルされた正規表現の有効期間を自分で管理Splitするには、インスタンスメソッドを使用します。To manage the lifetime of compiled regular expressions yourself, use the instance Split methods.

複数の一致が互いに隣接している場合は、空の文字列が配列に挿入されます。If multiple matches are adjacent to one another, an empty string is inserted into the array. たとえば、1つのハイフンに文字列を分割すると、返される配列には、隣接する2つのハイフンが見つかる位置に空の文字列が含まれます。For example, splitting a string on a single hyphen causes the returned array to include an empty string in the position where two adjacent hyphens are found.

入力文字列の先頭または末尾に一致が見つかった場合は、返された配列の先頭または末尾に空の文字列が含まれます。If a match is found at the beginning or the end of the input string, an empty string is included at the beginning or the end of the returned array. 次の例では、正規表現[a-z]+パターンを使用して、大文字または小文字のアルファベット文字で入力文字列を分割します。The following example uses the regular expression pattern [a-z]+ to split an input string on any uppercase or lowercase alphabetic character. 文字列の先頭と末尾が一致するアルファベット文字であるため、返された配列の最初の要素と最後String.Emptyの要素の値はになります。Because the string begins and ends with matching alphabetic characters, the value of the first and last element of the returned array is String.Empty.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "[a-z]+";
      string input = "Abc1234Def5678Ghi9012Jklm";
      string[] result = Regex.Split(input, pattern, 
                                    RegexOptions.IgnoreCase);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', '1234', '5678', '9012', ''
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "[a-z]+"
      Dim input As String = "Abc1234Def5678Ghi9012Jklm"
      Dim result() As String = Regex.Split(input, pattern, 
                                           RegexOptions.IgnoreCase)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', '1234', '5678', '9012', ''

Regex.Split式でキャプチャのかっこを使用する場合、キャプチャされたテキストは結果の文字列の配列に含まれます。If capturing parentheses are used in a Regex.Split expression, any captured text is included in the resulting string array. たとえば、キャプチャするかっこ内に配置されたハイフンで文字列 "plum" を分割した場合、返される配列にはハイフンを含む文字列要素が含まれます。For example, if you split the string "plum-pear" on a hyphen placed within capturing parentheses, the returned array includes a string element that contains the hyphen.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum-pear";
      string pattern = "(-)";

      string[] substrings = Regex.Split(input, pattern);    // Split on hyphens
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'      
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum-pear"
      Dim pattern As String = "(-)" 
      
      Dim substrings() As String = Regex.Split(input, pattern)    ' Split on hyphens.
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The method writes the following to the console:
'    'plum'
'    '-'
'    'pear'      

ただし、正規表現パターンに複数のキャプチャかっこのセットが含まれている場合、このメソッドの動作は .NET Framework のバージョンによって異なります。However, when the regular expression pattern includes multiple sets of capturing parentheses, the behavior of this method depends on the version of the .NET Framework. .NET Framework 1.0 および1.1 では、キャプチャのかっこの最初のセット内に一致が見つからない場合、キャプチャされた追加のかっこからキャプチャされたテキストは、返される配列には含まれません。In the .NET Framework 1.0 and 1.1, if a match is not found within the first set of capturing parentheses, captured text from additional capturing parentheses is not included in the returned array. .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返された配列に追加されます。Starting with the .NET Framework 2.0, all captured text is also added to the returned array. たとえば、次のコードでは、2組のキャプチャかっこを使用して、日付の区切り文字を含む日付の要素を日付文字列から抽出しています。For example, the following code uses two sets of capturing parentheses to extract the elements of a date, including the date delimiters, from a date string. キャプチャかっこの最初のセットはハイフンをキャプチャし、2番目のセットはスラッシュをキャプチャします。The first set of capturing parentheses captures the hyphen, and the second set captures the forward slash. コード例をコンパイルして .NET Framework 1.0 または1.1 の下で実行すると、スラッシュ文字は除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それが含まれます。If the example code is compiled and run under the .NET Framework 1.0 or 1.1, it excludes the slash characters; if it is compiled and run under the .NET Framework 2.0 or later versions, it includes them.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";

      foreach (string result in Regex.Split(input, pattern)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// In .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// In .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007' 
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      For Each result As String In Regex.Split(input, pattern) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007' 

正規表現が空の文字列と一致する場合Split 、は、すべての場所で空の文字列の区切り記号が見つかるため、文字列を1文字の文字列の配列に分割します。If the regular expression can match the empty string, Split will split the string into an array of single-character strings because the empty string delimiter can be found at every location.

このRegexMatchTimeoutException例外は、split 操作の実行時間が、メソッドが呼び出されたアプリケーションドメインに指定されたタイムアウト期間を超えた場合にスローされます。The RegexMatchTimeoutException exception is thrown if the execution time of the split operation exceeds the time-out interval specified for the application domain in which the method is called. アプリケーションドメインのプロパティでタイムアウトが定義されていない場合、またはタイムアウト値がRegex.InfiniteMatchTimeoutの場合は、例外はスローされません。If no time-out is defined in the application domain's properties, or if the time-out value is Regex.InfiniteMatchTimeout, no exception is thrown.

注意 (呼び出し元)

このメソッドは、メソッドが呼び出されたアプリケーションドメインの既定のタイムアウト値と同じ間隔の後にタイムアウトします。This method times out after an interval that is equal to the default time-out value of the application domain in which the method is called. タイムアウト値がアプリケーションドメインに対して定義されていない場合は、 InfiniteMatchTimeoutメソッドがタイムアウトしないようにする値が使用されます。If a time-out value has not been defined for the application domain, the value InfiniteMatchTimeout, which prevents the method from timing out, is used. パターン一致でテキストを分割するために推奨されるSplit(String, String, RegexOptions, TimeSpan)静的メソッドはです。これにより、タイムアウト間隔を設定できます。The recommended static method for splitting text on a pattern match is Split(String, String, RegexOptions, TimeSpan), which lets you set the time-out interval.

こちらもご覧ください

Split(String, Int32, Int32)

Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。Splits an input string a specified maximum number of times into an array of substrings, at the positions defined by a regular expression specified in the Regex constructor. 正規表現パターンの検索は、入力文字列の指定した文字位置から開始します。The search for the regular expression pattern starts at a specified character position in the input string.

public:
 cli::array <System::String ^> ^ Split(System::String ^ input, int count, int startat);
public string[] Split (string input, int count, int startat);
member this.Split : string * int * int -> string[]
Public Function Split (input As String, count As Integer, startat As Integer) As String()

パラメーター

input
String

分割対象の文字列。The string to be split.

count
Int32

分割を実行する最大回数。The maximum number of times the split can occur.

startat
Int32

入力文字列中で検索を開始する文字位置。The character position in the input string where the search will begin.

戻り値

String[]

文字列の配列。An array of strings.

例外

inputnullです。input is null.

startat が 0 未満か、input の長さを超えています。startat is less than zero or greater than the length of input.

タイムアウトが発生しました。A time-out occurred. タイムアウトの詳細については、「解説」をご覧ください。For more information about time-outs, see the Remarks section.

注釈

メソッドはString.Splitメソッドに似ていますが、 Regex.Splitは、文字セットではなく正規表現によって決定された区切り記号で文字列を分割する点が異なります。 Regex.SplitThe Regex.Split methods are similar to the String.Split method, except that Regex.Split splits the string at a delimiter determined by a regular expression instead of a set of characters. パラメーター countは、 input文字列が分割される部分文字列の最大数を指定します。最後の文字列には、文字列の解除の剰余が含まれます。The count parameter specifies the maximum number of substrings into which the input string is split; the last string contains the unsplit remainder of the string. countを0に設定すると、既定の動作が可能な限り数だけ分割されます。A count value of zero provides the default behavior of splitting as many times as possible. パラメーター startatは、最初の区切り記号の検索を開始するポイントを定義します (これは先頭の空白をスキップするために使用できます)。The startat parameter defines the point at which the search for the first delimiter begins (this can be used for skipping leading white space).

文字列のcount+ 1 位置から一致するものが見つからない場合、メソッドはinput文字列を含む1つの要素の配列を返します。If no matches are found from the count+1 position in the string, the method returns a one-element array that contains the input string. 1つ以上の一致が見つかった場合、返された配列の最初の要素には、最初の文字から一致する前の1文字までの文字列の最初の部分が含まれます。If one or more matches are found, the first element of the returned array contains the first portion of the string from the first character up to one character before the match.

複数の一致が互いに隣接していて、見つかった一致の数が少なくとcountも2未満の場合は、空の文字列が配列に挿入されます。If multiple matches are adjacent to one another and the number of matches found is at least two less than count, an empty string is inserted into the array. 同様に、文字列の最初の文字startatであるで一致が見つかった場合、返された配列の最初の要素は空の文字列になります。Similarly, if a match is found at startat, which is the first character in the string, the first element of the returned array is an empty string. つまり、隣接する一致の結果として返される空の文字列は、一致した部分count文字列の数がと等しいかどうかを判断するためにカウントされます。That is, empty strings that result from adjacent matches are counted in determining whether the number of matched substrings equals count. 次の例では、正規表現\d+を使用して、文字列内の数字の最初の部分文字列の開始位置を検索し、その位置から最大3回文字列を分割しています。In the following example, the regular expression \d+ is used to find the starting position of the first substring of numeric characters in a string, and then to split the string a maximum of three times starting at that position. 正規表現パターンは入力文字列の先頭に一致するので、返される文字列配列は、空の文字列、5文字のアルファベットの文字列、および文字列の残りの部分で構成されます。Because the regular expression pattern matches the beginning of the input string, the returned string array consists of an empty string, a five-character alphabetic string, and the remainder of the string,

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      Regex rgx = new Regex(pattern);
      string input = "123ABCDE456FGHIJ789KLMNO012PQRST";
      Match m = rgx.Match(input);
      if (m.Success) { 
         int startAt = m.Index;
         string[] result = rgx.Split(input, 3, startAt);
         for (int ctr = 0; ctr < result.Length; ctr++) {
            Console.Write("'{0}'", result[ctr]);
            if (ctr < result.Length - 1)
               Console.Write(", ");
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL789MNOPQ012'
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim rgx As New Regex(pattern)
      Dim input As String = "123ABCDE456FGHIJ789KLMNO012PQRST"
      Dim m As Match = rgx.Match(input)
      If m.Success Then 
         Dim startAt As Integer = m.Index
         Dim result() As String = rgx.Split(input, 3, startAt)
         For ctr As Integer = 0 To result.Length - 1
            Console.Write("'{0}'", result(ctr))
            If ctr < result.Length - 1 Then Console.Write(", ")
         Next
         Console.WriteLine()
      End If
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL789MNOPQ012'

正規表現でのキャプチャのかっこを使用する場合、キャプチャされたテキストは分割文字列の配列に含まれます。If capturing parentheses are used in a regular expression, any captured text is included in the array of split strings. ただし、キャプチャしたテキストを含む配列要素は、一致した数に達しcountたかどうかを判断するためにカウントされません。However, any array elements that contain captured text are not counted in determining whether the number of matches has reached count. たとえば、文字列 ' "apricot-plum-ザクロ-ピーチ" を文字列の15文字目から最大4つの部分文字列に分割すると、次のコードに示すように、7つの要素から成る配列が生成されます。For example, splitting the string '"apple-apricot-plum-pear-pomegranate-pineapple-peach" into a maximum of four substrings beginning at character 15 in the string results in a seven-element array, as the following code shows.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(-)"
      Dim input As String = "apple-apricot-plum-pear-pomegranate-pineapple-peach"

      Dim regex As Regex = New Regex(pattern)    
      ' Split on hyphens from 15th character on
      Dim substrings() As String = regex.Split(input, 4, 15)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub  
End Module
' The example displays the following output:
'    'apple-apricot-plum'
'    '-'
'    'pear'
'    '-'
'    'pomegranate'
'    '-'
'    'pineapple-peach'      

ただし、正規表現パターンに複数のキャプチャかっこのセットが含まれている場合、このメソッドの動作は .NET Framework のバージョンによって異なります。However, when the regular expression pattern includes multiple sets of capturing parentheses, the behavior of this method depends on the version of the .NET Framework. .NET Framework 1.0 および1.1 では、キャプチャのかっこの最初のセット内に一致が見つからない場合、キャプチャされた追加のかっこからキャプチャされたテキストは、返される配列には含まれません。In .NET Framework 1.0 and 1.1, if a match is not found within the first set of capturing parentheses, captured text from additional capturing parentheses is not included in the returned array. .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返された配列に追加されます。Starting with the .NET Framework 2.0, all captured text is also added to the returned array. たとえば、次のコードでは、2組のキャプチャかっこを使用して、文字列内の個々の単語を抽出しています。For example, the following code uses two sets of capturing parentheses to extract the individual words in a string. キャプチャかっこの最初のセットはハイフンをキャプチャし、2番目のセットは縦棒をキャプチャします。The first set of capturing parentheses captures the hyphen, and the second set captures the vertical bar. コード例がコンパイルされ、.NET Framework 1.0 または1.1 の下で実行されている場合は、垂直バー文字が除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それが含まれます。If the example code is compiled and run under the .NET Framework 1.0 or 1.1, it excludes the vertical bar characters; if it is compiled and run under the .NET Framework 2.0 or later versions, it includes them.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "(-)|([|])";     // possible delimiters found in string
      string input = "apple|apricot|plum|pear|pomegranate|pineapple|peach";

      Regex regex = new Regex(pattern);    
      // Split on delimiters from 15th character on
      string[] substrings = regex.Split(input, 4, 15);
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// In .NET 2.0 and later, the method returns an array of
// 7 elements, as follows:
//    apple|apricot|plum'
//    '|'
//    'pear'
//    '|'
//    'pomegranate'
//    '|'
//    'pineapple|peach'
// In .NET 1.0 and 1.1, the method returns an array of
// 4 elements, as follows:
//    'apple|apricot|plum'
//    'pear'
//    'pomegranate'
//    'pineapple|peach'
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(-)|([|])"   ' possible delimiters found in string
      Dim input As String = "apple|apricot|plum|pear|pomegranate|pineapple|peach"

      Dim regex As Regex = New Regex(pattern)    
      ' Split on delimiters from 15th character on
      Dim substrings() As String = regex.Split(input, 4, 15)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' In .NET 2.0, the method returns an array of
' 7 elements, as follows:
'    apple|apricot|plum'
'    '|'
'    'pear'
'    '|'
'    'pomegranate'
'    '|'
'    'pineapple|peach'
' In .NET 1.0 and 1.1, the method returns an array of
' 4 elements, as follows:
'    'apple|apricot|plum'
'    'pear'
'    'pomegranate'
'    'pineapple|peach'

正規表現が空の文字列と一致する場合Split 、は、すべての場所で空の文字列の区切り記号が見つかるため、文字列を1文字の文字列の配列に分割します。If the regular expression can match the empty string, Split will split the string into an array of single-character strings because the empty string delimiter can be found at every location. 次の例では、文字列 "characters" を入力文字列に含まれる数の要素に分割し、文字 "a" から始めます。The following example splits the string "characters" into as many elements as the input string contains, starting with the character "a". Null 文字列は入力文字列の末尾に一致するので、返された配列の末尾に null 文字列が挿入されます。Because the null string matches the end of the input string, a null string is inserted at the end of the returned array.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "characters";
      Regex regex = new Regex("");
      string[] substrings = regex.Split(input, input.Length, input.IndexOf("a"));
      Console.Write("{");
      for(int ctr = 0; ctr < substrings.Length; ctr++)
      {
         Console.Write(substrings[ctr]);
         if (ctr < substrings.Length - 1)
            Console.Write(", ");
      }
      Console.WriteLine("}");
   }
}
// The example displays the following output:   
//    {, c, h, a, r, a, c, t, e, rs}
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "characters"
      Dim regex As New Regex("")
      Dim substrings() As String = regex.Split(input, input.Length, _
                                               input.IndexOf("a"))
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write(substrings(ctr))
         If ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example produces the following output:   
'    {, c, h, a, r, a, c, t, e, rs}

この例外は、分割操作の実行時間が、 Regex.Regex(String, RegexOptions, TimeSpan)コンストラクターで指定されたタイムアウト期間を超えた場合にスローされます。 RegexMatchTimeoutExceptionThe RegexMatchTimeoutException exception is thrown if the execution time of the split operation exceeds the time-out interval specified by the Regex.Regex(String, RegexOptions, TimeSpan) constructor. コンストラクターを呼び出すときにタイムアウト間隔を設定しなかった場合は、 Regexオブジェクトが作成されたアプリケーションドメインに対して設定されたタイムアウト値を操作が超えた場合に、例外がスローされます。If you do not set a time-out interval when you call the constructor, the exception is thrown if the operation exceeds any time-out value established for the application domain in which the Regex object is created. Regexコンストラクター呼び出しまたはアプリケーションドメインのプロパティでタイムアウトが定義されていない場合、またはタイムアウト値がRegex.InfiniteMatchTimeoutの場合、例外はスローされません。If no time-out is defined in the Regex constructor call or in the application domain's properties, or if the time-out value is Regex.InfiniteMatchTimeout, no exception is thrown

こちらもご覧ください

Split(String, Int32)

Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。Splits an input string a specified maximum number of times into an array of substrings, at the positions defined by a regular expression specified in the Regex constructor.

public:
 cli::array <System::String ^> ^ Split(System::String ^ input, int count);
public string[] Split (string input, int count);
member this.Split : string * int -> string[]
Public Function Split (input As String, count As Integer) As String()

パラメーター

input
String

分割対象の文字列。The string to be split.

count
Int32

分割を実行する最大回数。The maximum number of times the split can occur.

戻り値

String[]

文字列の配列。An array of strings.

例外

inputnullです。input is null.

タイムアウトが発生しました。A time-out occurred. タイムアウトの詳細については、「解説」をご覧ください。For more information about time-outs, see the Remarks section.

注釈

メソッドはString.Splitメソッドに似ていますが、 Regex.Splitは、文字セットではなく正規表現によって決定された区切り記号で文字列を分割する点が異なります。 Regex.SplitThe Regex.Split methods are similar to the String.Split method, except that Regex.Split splits the string at a delimiter determined by a regular expression instead of a set of characters. パラメーター countは、 input文字列を分割できる部分文字列の最大数を指定します。最後の文字列には、文字列の解除の剰余が含まれます。The count parameter specifies the maximum number of substrings into which the input string can be split; the last string contains the unsplit remainder of the string. countを0に設定すると、既定の動作が可能な限り数だけ分割されます。A count value of zero provides the default behavior of splitting as many times as possible.

複数の一致が互いに隣接している場合、またはのinput先頭または末尾に一致が検出され、見つかった一致の数が少なくともcount2 未満の場合は、空の文字列が配列に挿入されます。If multiple matches are adjacent to one another or if a match is found at the beginning or end of input, and the number of matches found is at least two less than count, an empty string is inserted into the array. つまり、入力文字列の先頭または末尾にある隣接する一致または一致からの結果として返される空の文字列は、一致したcount部分文字列の数がと等しいかどうかを判断するためにカウントされます。That is, empty strings that result from adjacent matches or from matches at the beginning or end of the input string are counted in determining whether the number of matched substrings equals count. 次の例では、正規表現/d+を使用して、1桁以上の10進数を含む入力文字列を最大3つの部分文字列に分割します。In the following example, the regular expression /d+ is used to split an input string that includes one or more decimal digits into a maximum of three substrings. 入力文字列の先頭が正規表現パターンに一致するため、最初の配列要素にString.Emptyはが含まれ、2番目の配列要素には入力文字列内の最初のアルファベット文字セットが格納され、3番目の文字には文字列の残りの部分が含まれます。これは3番目の一致の後に続きます。Because the beginning of the input string matches the regular expression pattern, the first array element contains String.Empty, the second contains the first set of alphabetic characters in the input string, and the third contains the remainder of the string that follows the third match.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      Regex rgx = new Regex(pattern);
      string input = "123ABCDE456FGHIJKL789MNOPQ012";
      
      string[] result = rgx.Split(input, 3);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL789MNOPQ012'
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim rgx As New Regex(pattern)
      Dim input As String = "123ABCDE456FGHIJKL789MNOPQ012"
      
      Dim result() As String = rgx.Split(input, 3)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL789MNOPQ012'

正規表現でのキャプチャのかっこを使用する場合、キャプチャされたテキストは分割文字列の配列に含まれます。If capturing parentheses are used in a regular expression, any captured text is included in the array of split strings. ただし、キャプチャしたテキストを含む配列要素は、一致した数に達しcountたかどうかを判断するためにカウントされません。However, any array elements that contain captured text are not counted in determining whether the number of matches has reached count. たとえば、文字列 "apricot-plum" を最大4つの部分文字列に分割すると、次のコードに示すように、7要素の配列が生成されます。For example, splitting the string "apple-apricot-plum-pear-banana" into a maximum of four substrings results in a seven-element array, as the following code shows.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "(-)";
      string input = "apple-apricot-plum-pear-banana";
      Regex regex = new Regex(pattern);         // Split on hyphens.
      string[] substrings = regex.Split(input, 4);
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//       'apple'
//       '-'
//       'apricot'
//       '-'
//       'plum'
//       '-'
//       'pear-banana'      
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(-)"
      Dim input As String = "apple-apricot-plum-pear-banana"
      Dim regex As Regex = New Regex(pattern)         ' Split on hyphens.
      Dim substrings() As String = regex.Split(input, 4)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The example displays the following output:
'    'apple'
'    '-'
'    'apricot'
'    '-'
'    'plum'
'    '-'
'    'pear-banana'      

ただし、正規表現パターンに複数のキャプチャかっこのセットが含まれている場合、このメソッドの動作は .NET Framework のバージョンによって異なります。However, when the regular expression pattern includes multiple sets of capturing parentheses, the behavior of this method depends on the version of the .NET Framework. .NET Framework 1.0 および1.1 では、キャプチャされた最初のかっこのセットからキャプチャされたテキストだけが、返された配列に含まれます。In the .NET Framework 1.0 and 1.1, only captured text from the first set of capturing parentheses is included in the returned array. .NET Framework 2.0 以降では、キャプチャされたすべてのテキストが返された配列に追加されます。Starting with the .NET Framework 2.0, all captured text is added to the returned array. ただし、キャプチャされたテキストを含む、返された配列内の要素は、一致した部分count文字列の数がと等しいかどうかを判断するためにカウントされません。However, elements in the returned array that contain captured text are not counted in determining whether the number of matched substrings equals count. たとえば、次のコードでは、正規表現は2セットのキャプチャかっこを使用して、日付文字列から日付の要素を抽出します。For example, in the following code, a regular expression uses two sets of capturing parentheses to extract the elements of a date from a date string. キャプチャかっこの最初のセットはハイフンをキャプチャし、2番目のセットはスラッシュをキャプチャします。The first set of capturing parentheses captures the hyphen, and the second set captures the forward slash. 次に、 Split(String, Int32)メソッドを呼び出すと、返される配列の中で最大2つの要素が指定されます。The call to the Split(String, Int32) method then specifies a maximum of two elements in the returned array. コード例がコンパイルされ、.NET Framework 1.0 または1.1 の下で実行される場合、メソッドは2要素の文字列配列を返します。If the example code is compiled and run under the .NET Framework 1.0 or 1.1, the method returns a two-element string array. コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合、メソッドは3要素の文字列配列を返します。If it is compiled and run under the .NET Framework 2.0 or later versions, the method returns a three-element string array.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";
      Regex regex = new Regex(pattern);
      foreach (string result in regex.Split(input, 2)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// Under .NET 1.0 and 1.1, the method returns an array of
// 2 elements, as follows:
//    '07'
//    '14/2007'
//
// Under .NET 2.0 and later, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '/'
//    '14/2007' 
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      Dim regex As Regex = New Regex(pattern)
      For Each result As String In regex.Split(input, 2) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 2 elements, as follows:
'    '07'
'    '14/2007'
'
' In .NET 2.0 and later, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '/'
'    '14/2007' 

正規表現が空の文字列と一致する場合Split(String, Int32) 、は、すべての場所で空の文字列の区切り記号が見つかるため、文字列を1文字の文字列の配列に分割します。If the regular expression can match the empty string, Split(String, Int32) will split the string into an array of single-character strings because the empty string delimiter can be found at every location. 次の例では、入力文字列に含まれるのと同じ数の要素に文字列 "characters" を分割します。The following example splits the string "characters" into as many elements as there are in the input string. Null 文字列は入力文字列の先頭に一致するので、返された配列の先頭に null 文字列が挿入されます。Because the null string matches the beginning of the input string, a null string is inserted at the beginning of the returned array. これにより、10番目の要素は入力文字列の末尾にある2つの文字で構成されます。This causes the tenth element to consist of the two characters at the end of the input string.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "characters"
      Dim regex As New Regex("")
      Dim substrings() As String = regex.Split(input, input.Length)
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write(substrings(ctr))
         if ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example displays the following output:   
'    {, c, h, a, r, a, c, t, e, rs}

この例外は、分割操作の実行時間が、 Regex.Regex(String, RegexOptions, TimeSpan)コンストラクターで指定されたタイムアウト期間を超えた場合にスローされます。 RegexMatchTimeoutExceptionThe RegexMatchTimeoutException exception is thrown if the execution time of the split operation exceeds the time-out interval specified by the Regex.Regex(String, RegexOptions, TimeSpan) constructor. コンストラクターを呼び出すときにタイムアウト間隔を設定しなかった場合は、 Regexオブジェクトが作成されたアプリケーションドメインに対して設定されたタイムアウト値を操作が超えた場合に、例外がスローされます。If you do not set a time-out interval when you call the constructor, the exception is thrown if the operation exceeds any time-out value established for the application domain in which the Regex object is created. Regexコンストラクター呼び出しまたはアプリケーションドメインのプロパティでタイムアウトが定義されていない場合、またはタイムアウト値がRegex.InfiniteMatchTimeoutの場合、例外はスローされません。If no time-out is defined in the Regex constructor call or in the application domain's properties, or if the time-out value is Regex.InfiniteMatchTimeout, no exception is thrown

こちらもご覧ください

Split(String)

Regex コンストラクターで指定された正規表現パターンによって定義されている位置で入力文字列を分割し、部分文字列の配列に格納します。Splits an input string into an array of substrings at the positions defined by a regular expression pattern specified in the Regex constructor.

public:
 cli::array <System::String ^> ^ Split(System::String ^ input);
public string[] Split (string input);
member this.Split : string -> string[]
Public Function Split (input As String) As String()

パラメーター

input
String

分割対象の文字列。The string to split.

戻り値

String[]

文字列の配列。An array of strings.

例外

inputnull です。input is null.

タイムアウトが発生しました。A time-out occurred. タイムアウトの詳細については、「解説」をご覧ください。For more information about time-outs, see the Remarks section.

注釈

メソッドはString.Split(Char[])メソッドに似ていますが、 Regex.Splitは、文字セットではなく正規表現によって決定された区切り記号で文字列を分割する点が異なります。 Regex.SplitThe Regex.Split methods are similar to the String.Split(Char[]) method, except that Regex.Split splits the string at a delimiter determined by a regular expression instead of a set of characters. 文字列は、できるだけ多くの回数だけ分割されます。The string is split as many times as possible. 区切り記号が見つからない場合、戻り値には、元の入力文字列を値として持つ1つの要素が含まれます。If no delimiter is found, the return value contains one element whose value is the original input string.

複数の一致が互いに隣接している場合は、空の文字列が配列に挿入されます。If multiple matches are adjacent to one another, an empty string is inserted into the array. たとえば、1つのハイフンに文字列を分割すると、次のコードに示すように、返された配列には隣接する2つのハイフンが見つかった位置に空の文字列が含まれます。For example, splitting a string on a single hyphen causes the returned array to include an empty string in the position where two adjacent hyphens are found, as the following code shows.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      Regex regex = new Regex("-");         // Split on hyphens.
      string[] substrings = regex.Split("plum--pear");
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    ''
//    'pear'      
Imports System.Text.RegularExpressions

Module RegexSplit
   Public Sub Main()
      Dim regex As Regex = New Regex("-")         ' Split on hyphens.
      Dim substrings() As String = regex.Split("plum--pear")
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The example displays the following output:
'    'plum'
'    ''
'    'pear'      

入力文字列の先頭または末尾に一致が見つかった場合は、返された配列の先頭または末尾に空の文字列が含まれます。If a match is found at the beginning or the end of the input string, an empty string is included at the beginning or the end of the returned array. 次の例では、正規表現\d+パターンを使用して、入力文字列を数値文字で分割しています。The following example uses the regular expression pattern \d+ to split an input string on numeric characters. 文字列の先頭と末尾が一致する数字であるため、返された配列の最初の要素と最後のString.Empty要素の値はになります。Because the string begins and ends with matching numeric characters, the value of the first and last element of the returned array is String.Empty.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      Regex rgx = new Regex(pattern);
      string input = "123ABCDE456FGHIJKL789MNOPQ012";
      
      string[] result = rgx.Split(input);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim rgx As New Regex(pattern)
      Dim input As String = "123ABCDE456FGHIJKL789MNOPQ012"
      
      Dim result() As String = rgx.Split(input)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''

Regex.Split式でキャプチャのかっこを使用する場合、キャプチャされたテキストは結果の文字列の配列に含まれます。If capturing parentheses are used in a Regex.Split expression, any captured text is included in the resulting string array. たとえば、キャプチャするかっこ内に配置されたハイフンで文字列 "plum" を分割した場合、返される配列にはハイフンを含む文字列要素が含まれます。For example, if you split the string "plum-pear" on a hyphen placed within capturing parentheses, the returned array includes a string element that contains the hyphen.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      Regex regex = new Regex("(-)");         // Split on hyphens.
      string[] substrings = regex.Split("plum-pear");
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'      
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim regex As Regex = New Regex("(-)")          ' Split on hyphens.
      Dim substrings() As String = regex.Split("plum-pear")
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The example displays the following output:
'    'plum'
'    '-'
'    'pear'      

ただし、正規表現パターンに複数のキャプチャかっこのセットが含まれている場合、このメソッドの動作は .NET Framework のバージョンによって異なります。However, when the regular expression pattern includes multiple sets of capturing parentheses, the behavior of this method depends on the version of the .NET Framework. .NET Framework 1.0 および1.1 では、キャプチャのかっこの最初のセット内に一致が見つからない場合、キャプチャされた追加のかっこからキャプチャされたテキストは、返される配列には含まれません。In the .NET Framework 1.0 and 1.1, if a match is not found within the first set of capturing parentheses, captured text from additional capturing parentheses is not included in the returned array. .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返された配列に追加されます。Starting with the .NET Framework 2.0, all captured text is also added to the returned array. たとえば、次のコードでは、2組のキャプチャかっこを使用して、日付の区切り文字を含む日付の要素を日付文字列から抽出しています。For example, the following code uses two sets of capturing parentheses to extract the elements of a date, including the date delimiters, from a date string. キャプチャかっこの最初のセットはハイフンをキャプチャし、2番目のセットはスラッシュをキャプチャします。The first set of capturing parentheses captures the hyphen, and the second set captures the forward slash. コード例をコンパイルして .NET Framework 1.0 または1.1 の下で実行すると、スラッシュ文字は除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それが含まれます。If the example code is compiled and run under the .NET Framework 1.0 or 1.1, it excludes the slash characters; if it is compiled and run under the .NET Framework 2.0 or later versions, it includes them.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";
      Regex regex = new Regex(pattern);
      foreach (string result in regex.Split(input)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// Under .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// Under .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007' 
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      Dim regex As Regex = New Regex(pattern)
      For Each result As String In regex.Split(input) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007' 

正規表現が空の文字列と一致する場合Split(String) 、は、すべての場所で空の文字列の区切り記号が見つかるため、文字列を1文字の文字列の配列に分割します。If the regular expression can match the empty string, Split(String) will split the string into an array of single-character strings because the empty string delimiter can be found at every location. 次に例を示します。For example:

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "characters";
      Regex regex = new Regex("");
      string[] substrings = regex.Split(input);
      Console.Write("{");
      for(int ctr = 0; ctr < substrings.Length; ctr++)
      {
         Console.Write(substrings[ctr]);
         if (ctr < substrings.Length - 1)
            Console.Write(", ");
      }
      Console.WriteLine("}");
   }
}
// The example displays the following output:   
//    {, c, h, a, r, a, c, t, e, r, s, }
Imports System.Text.RegularExpressions

Module Main
   Public Sub Main()
      Dim input As String = "characters"
      Dim regex As New Regex("")
      Dim substrings() As String = regex.Split(input)
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write(substrings(ctr))
         If ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example produces the following output:   
'    {, c, h, a, r, a, c, t, e, r, s, }

返された配列には、配列の先頭と末尾に空の文字列も含まれていることに注意してください。Note that the returned array also includes an empty string at the beginning and end of the array.

この例外は、分割操作の実行時間が、 Regex.Regex(String, RegexOptions, TimeSpan)コンストラクターで指定されたタイムアウト期間を超えた場合にスローされます。 RegexMatchTimeoutExceptionThe RegexMatchTimeoutException exception is thrown if the execution time of the split operation exceeds the time-out interval specified by the Regex.Regex(String, RegexOptions, TimeSpan) constructor. コンストラクターを呼び出すときにタイムアウト間隔を設定しなかった場合は、 Regexオブジェクトが作成されたアプリケーションドメインに対して設定されたタイムアウト値を操作が超えた場合に、例外がスローされます。If you do not set a time-out interval when you call the constructor, the exception is thrown if the operation exceeds any time-out value established for the application domain in which the Regex object is created. Regexコンストラクター呼び出しまたはアプリケーションドメインのプロパティでタイムアウトが定義されていない場合、またはタイムアウト値がRegex.InfiniteMatchTimeoutの場合、例外はスローされません。If no time-out is defined in the Regex constructor call or in the application domain's properties, or if the time-out value is Regex.InfiniteMatchTimeout, no exception is thrown

こちらもご覧ください

Split(String, String)

正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。Splits an input string into an array of substrings at the positions defined by a regular expression pattern.

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern);
public static string[] Split (string input, string pattern);
static member Split : string * string -> string[]
Public Shared Function Split (input As String, pattern As String) As String()

パラメーター

input
String

分割対象の文字列。The string to split.

pattern
String

一致させる正規表現パターン。The regular expression pattern to match.

戻り値

String[]

文字列の配列。An array of strings.

例外

正規表現の解析エラーが発生しました。A regular expression parsing error occurred.

input または patternnull です。input or pattern is null.

タイムアウトが発生しました。A time-out occurred. タイムアウトの詳細については、「解説」をご覧ください。For more information about time-outs, see the Remarks section.

注釈

メソッドはString.Splitメソッドに似ていますが、 Regex.Splitは、文字セットではなく正規表現によって決定された区切り記号で文字列を分割する点が異なります。 Regex.SplitThe Regex.Split methods are similar to the String.Split method, except that Regex.Split splits the string at a delimiter determined by a regular expression instead of a set of characters. 文字列inputは、できるだけ多くの回数だけ分割されます。The input string is split as many times as possible. pattern 文字列input内に見つからない場合、戻り値には、元inputの文字列を値とする1つの要素が含まれます。If pattern is not found in the input string, the return value contains one element whose value is the original input string.

パラメーター patternは、一致させる文字列をシンボリックに記述する正規表現言語要素で構成されます。The pattern parameter consists of regular expression language elements that symbolically describe the string to match. 正規表現の詳細については、「 .NET Framework 正規表現正規表現言語-クイックリファレンス」を参照してください。For more information about regular expressions, see .NET Framework Regular Expressions and Regular Expression Language - Quick Reference.

重要

静的Splitメソッドの呼び出しで使用されるコンパイル済みの正規表現は、自動的にキャッシュされます。Compiled regular expressions used in calls to static Split methods are automatically cached. コンパイルされた正規表現の有効期間を自分で管理Splitするには、インスタンスメソッドを使用します。To manage the lifetime of compiled regular expressions yourself, use the instance Split methods.

複数の一致が互いに隣接している場合は、空の文字列が配列に挿入されます。If multiple matches are adjacent to one another, an empty string is inserted into the array. たとえば、1つのハイフンに文字列を分割すると、次のコードに示すように、返された配列には隣接する2つのハイフンが見つかった位置に空の文字列が含まれます。For example, splitting a string on a single hyphen causes the returned array to include an empty string in the position where two adjacent hyphens are found, as the following code shows.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum--pear";
      string pattern = "-";            // Split on hyphens
      
      string[] substrings = Regex.Split(input, pattern);
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The method displays the following output:
//    'plum'
//    ''
//    'pear'      
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum--pear"
      Dim pattern As String = "-"          ' Split on hyphens
      
      Dim substrings() As String = Regex.Split(input, pattern)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub  
End Module
' The example displays the following output:
'    'plum'
'    ''
'    'pear'      

入力文字列の先頭または末尾に一致が見つかった場合は、返された配列の先頭または末尾に空の文字列が含まれます。If a match is found at the beginning or the end of the input string, an empty string is included at the beginning or the end of the returned array. 次の例では、正規表現\d+パターンを使用して、入力文字列を数値文字で分割しています。The following example uses the regular expression pattern \d+ to split an input string on numeric characters. 文字列の先頭と末尾が一致する数字であるため、返された配列の最初の要素と最後のString.Empty要素の値はになります。Because the string begins and ends with matching numeric characters, the value of the first and last element of the returned array is String.Empty.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      string input = "123ABCDE456FGHIJKL789MNOPQ012";
      string[] result = Regex.Split(input, pattern);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim input As String = "123ABCDE456FGHIJKL789MNOPQ012"
      Dim result() As String = Regex.Split(input, pattern)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''

Regex.Split式でキャプチャのかっこを使用する場合、キャプチャされたテキストは結果の文字列の配列に含まれます。If capturing parentheses are used in a Regex.Split expression, any captured text is included in the resulting string array. たとえば、キャプチャするかっこ内に配置されたハイフンで文字列 "plum" を分割した場合、返される配列にはハイフンを含む文字列要素が含まれます。For example, if you split the string "plum-pear" on a hyphen placed within capturing parentheses, the returned array includes a string element that contains the hyphen.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum-pear";
      string pattern = "(-)";

      string[] substrings = Regex.Split(input, pattern);    // Split on hyphens
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'      
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum-pear"
      Dim pattern As String = "(-)" 
      
      Dim substrings() As String = Regex.Split(input, pattern)    ' Split on hyphens.
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The method writes the following to the console:
'    'plum'
'    '-'
'    'pear'      

ただし、正規表現パターンに複数のキャプチャかっこのセットが含まれている場合、このメソッドの動作は .NET Framework のバージョンによって異なります。However, when the regular expression pattern includes multiple sets of capturing parentheses, the behavior of this method depends on the version of the .NET Framework. .NET Framework 1.0 および1.1 では、キャプチャのかっこの最初のセット内に一致が見つからない場合、キャプチャされた追加のかっこからキャプチャされたテキストは、返される配列には含まれません。In the .NET Framework 1.0 and 1.1, if a match is not found within the first set of capturing parentheses, captured text from additional capturing parentheses is not included in the returned array. .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返された配列に追加されます。Starting with the .NET Framework 2.0, all captured text is also added to the returned array. たとえば、次のコードでは、2組のキャプチャかっこを使用して、日付の区切り文字を含む日付の要素を日付文字列から抽出しています。For example, the following code uses two sets of capturing parentheses to extract the elements of a date, including the date delimiters, from a date string. キャプチャかっこの最初のセットはハイフンをキャプチャし、2番目のセットはスラッシュをキャプチャします。The first set of capturing parentheses captures the hyphen, and the second set captures the forward slash. コード例をコンパイルして .NET Framework 1.0 または1.1 の下で実行すると、スラッシュ文字は除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それが含まれます。If the example code is compiled and run under the .NET Framework 1.0 or 1.1, it excludes the slash characters; if it is compiled and run under the .NET Framework 2.0 or later versions, it includes them.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";

      foreach (string result in Regex.Split(input, pattern)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// In .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// In .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007' 
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      For Each result As String In Regex.Split(input, pattern) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007' 

正規表現が空の文字列と一致する場合Split 、は、すべての場所で空の文字列の区切り記号が見つかるため、文字列を1文字の文字列の配列に分割します。If the regular expression can match the empty string, Split will split the string into an array of single-character strings because the empty string delimiter can be found at every location. 次に例を示します。For example:

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "characters";
      string[] substrings = Regex.Split(input, "");
      Console.Write("{");
      for(int ctr = 0; ctr < substrings.Length; ctr++)
      {
         Console.Write("'{0}'", substrings[ctr]);
         if (ctr < substrings.Length - 1)
            Console.Write(", ");
      }
      Console.WriteLine("}");
   }
}
// The example produces the following output:   
//    {'', 'c', 'h', 'a', 'r', 'a', 'c', 't', 'e', 'r', 's', ''}
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "characters"
      Dim substrings() As String = Regex.Split(input, "")
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write("'{0}'", substrings(ctr))
         If ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example produces the following output:   
'    {'', 'c', 'h', 'a', 'r', 'a', 'c', 't', 'e', 'r', 's', ''}

返された配列には、配列の先頭と末尾に空の文字列も含まれていることに注意してください。Note that the returned array also includes an empty string at the beginning and end of the array.

このRegexMatchTimeoutException例外は、split 操作の実行時間が、メソッドが呼び出されたアプリケーションドメインに指定されたタイムアウト期間を超えた場合にスローされます。The RegexMatchTimeoutException exception is thrown if the execution time of the split operation exceeds the time-out interval specified for the application domain in which the method is called. アプリケーションドメインのプロパティでタイムアウトが定義されていない場合、またはタイムアウト値がRegex.InfiniteMatchTimeoutの場合は、例外はスローされません。If no time-out is defined in the application domain's properties, or if the time-out value is Regex.InfiniteMatchTimeout, no exception is thrown.

注意 (呼び出し元)

このメソッドは、メソッドが呼び出されたアプリケーションドメインの既定のタイムアウト値と同じ間隔の後にタイムアウトします。This method times out after an interval that is equal to the default time-out value of the application domain in which the method is called. タイムアウト値がアプリケーションドメインに対して定義されていない場合は、 InfiniteMatchTimeoutメソッドがタイムアウトしないようにする値が使用されます。If a time-out value has not been defined for the application domain, the value InfiniteMatchTimeout, which prevents the method from timing out, is used. パターン一致でテキストを分割するために推奨されるSplit(String, String, RegexOptions, TimeSpan)静的メソッドはです。これにより、タイムアウト間隔を設定できます。The recommended static method for splitting text on a pattern match is Split(String, String, RegexOptions, TimeSpan), which lets you set the time-out interval.

こちらもご覧ください

適用対象