エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

String.Split メソッド (String[], Int32, StringSplitOptions)

2013/12/12

指定された文字列の配列の要素で区切られた、この文字列の部分文字列を格納する文字列配列を返します。返される部分文字列の最大数と、空の配列要素を返すかどうかをパラメーターで指定します。

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

public string[] Split(
	string[] separator,
	int count,
	StringSplitOptions options
)

パラメーター

separator
型: System.String []
この文字列での部分文字列の区切り文字である文字列の配列、区切り文字が含まれない空の配列、または null
count
型: System.Int32
返される最大の部分文字列数。
options
型: System.StringSplitOptions
返される配列から空の配列要素を省略する場合は RemoveEmptyEntries。返される配列に空の配列要素も含める場合は None

戻り値

型: System.String []
この文字列を、separator 配列のいずれかまたは複数の要素 (文字列) で区切ることによって取り出された部分文字列を格納する配列。詳細については、「解説」を参照してください。

例外条件
ArgumentOutOfRangeException

count が負の値です。

ArgumentException

optionsStringSplitOptions 値ではありません。

戻り値に関する情報

返される配列要素に区切り記号文字列は含まれません。

このインスタンスに、separator に指定されたいずれの文字列も含まれていない場合、または count パラメーターの値が 1 の場合、返される配列にはそのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメーターが null の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。空白文字は Unicode 規格によって定義され、Char.IsWhiteSpace メソッドに渡された場合は、true を返します。ただし、このメソッド オーバーロードの呼び出しの separator パラメーターが null の場合、コンパイラのオーバーロード解決は失敗します。呼び出されたメソッドを明確に識別するには、コードが null 型を指定する必要があります。このオーバーロードを明確に識別するいくつかの方法を次の例に示します。

count パラメーターがゼロの場合、または、options パラメーターが RemoveEmptyEntries で、このインスタンスの長さがゼロの場合、空の配列が返されます。

separator の各要素は、1 つ以上の文字で構成された区切り記号を定義します。options パラメーターが None で、2 つの区切り記号が隣接している場合、または、区切り記号がこのインスタンスの先頭か末尾に見つかった場合、対応する配列の要素には Empty が格納されます。

このインスタンスに count を超える部分文字列が含まれていた場合、count - 1 番目にある最初の部分文字列が、戻り値の count - 1 番目の最初の要素として返されます。このインスタンスに含まれるそれ以外の文字は、戻り値の最後の要素として返されます。

count が部分文字列の数よりも多い場合、取り出せるだけの部分文字列が返され、例外はスローされません。

比較に関する情報

Split メソッドは、この文字列を、separator パラメーターで指定された 1 つまたは複数の文字列で区切ることによって部分文字列を抽出し、これらの部分文字列を配列の要素として返します。

Split メソッドが区切り記号を検索する際の比較処理では、大文字と小文字は区別され、序数の並べ替え規則が使用されます。単語、文字列、序数の並べ替えの詳細については、System.Globalization.CompareOptions 列挙値のトピックを参照してください。

Split メソッドでは、値が null または空の文字列 ("") である separator の要素は無視されます。

separator に格納された複数の文字列に共通の文字が使用されていた場合にあいまいな結果が生じるのを防ぐため、Split メソッドは、対象のインスタンスの値を先頭から最後まで解析し、separator 内の要素と最初に一致した要素を区切り文字として使用します。インスタンスにおける部分文字列の出現順が、separator における要素の格納順よりも優先されます。

たとえば、値が "abcdef" であるインスタンスがあるとします。separator の 1 つ目の要素が "ef"、2 つ目の要素が "bcde" であった場合、分割処理の結果は "a" と "f" になります。インスタンス内の部分文字列 "bcde" が、部分文字列 "f" よりも先に separator 内の要素と一致するためです。

ただし、separator の 1 つ目の要素が "bcd" で、2 つ目の要素が "bc" であった場合、分割処理の結果は "a" と "ef" になります。これは、"bcd" が、separator に格納された要素のうち、インスタンス内の区切り記号と一致する最初の要素であるためです。separator に格納された要素の順序が逆だった場合、つまり、1 つ目の要素が "bc" で、2 つ目の要素が "bcd" であった場合、分割処理の結果は "a" と "def" となります。

パフォーマンスに関する考慮事項

Split メソッドでは、返される配列オブジェクト用と、各配列要素の String オブジェクト用にメモリが確保されます。アプリケーション開発においてパフォーマンスの最適化が必要とされる場合、または、アプリケーション開発においてメモリ割り当ての管理がきわめて重要な要件となる場合は、IndexOf メソッドまたは IndexOfAny メソッドと、(必要に応じて) Compare メソッドを使用して文字列から部分文字列を検索します。

区切り記号文字の位置で文字列を分割する場合は、IndexOf メソッドまたは IndexOfAny メソッドを使用して、文字列中の区切り記号文字を検索します。区切り記号文字列の位置で文字列を分割する場合は、IndexOf メソッドまたは IndexOfAny メソッドを使用して、区切り記号文字列の最初の文字を検索します。次に、Compare メソッドを使用して、最初の文字に続く文字が区切り記号文字列の残りの文字に等しいかどうかを判断します。

また、複数の Split メソッド呼び出しで同じ文字セットが文字列の分割に使用される場合は、配列を 1 つだけ作成して各メソッド呼び出しで参照することを検討してください。こうすることで、各メソッド呼び出しのオーバーヘッドを大幅に低減できます。

呼び出し時の注意

.NET Framework 3.5 以前のバージョンでは、null であるか、または文字が含まれていない separatorSplit メソッドに渡された場合、このメソッドは Trim メソッドが文字列をトリムするために使用したものとは少し異なる文字セットを使用して文字列を分割します。.NET Framework 4 では、両方のメソッドがまったく同じ Unicode 空白文字セットを使用します。

Split メソッドによって生成される部分文字列を結果に含めるか除外するかを StringSplitOptions 列挙値を使って指定する例を次に示します。


using System;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      string s1 = ",ONE,,TWO,,,THREE,,";
      string s2 = "[stop]" +
                  "ONE[stop][stop]" +
                  "TWO[stop][stop][stop]" +
                  "THREE[stop][stop]";
      char[] charSeparators = { ',' };
      string[] stringSeparator = {"[stop]"};
      string[] result;
      // ------------------------------------------------------------------------------
      // Split a string delimited by characters.
      // ------------------------------------------------------------------------------
      outputBlock.Text += "1) Split a string delimited by characters:\n" + "\n";

      // Display the original string and delimiter characters.
      outputBlock.Text += String.Format("1a )The original string is \"{0}\".", s1) + "\n";
      outputBlock.Text += String.Format("The delimiter character is '{0}'.\n",
                         charSeparators[0]) + "\n";

      // Split a string delimited by characters and return all elements.
      outputBlock.Text += String.Format("1b) Split a string delimited by characters and " +
                        "return all elements:") + "\n";
      result = s1.Split(charSeparators, StringSplitOptions.None);
      Show(outputBlock, result);

      // Split a string delimited by characters and return all non-empty elements.
      outputBlock.Text += String.Format("1c) Split a string delimited by characters and " +
                        "return all non-empty elements:") + "\n";
      result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries);
      Show(outputBlock, result);

      // ------------------------------------------------------------------------------
      // Split a string delimited by another string.
      // ------------------------------------------------------------------------------
      outputBlock.Text += "2) Split a string delimited by another string:\n" + "\n";

      // Display the original string and delimiter string.
      outputBlock.Text += String.Format("2a) The original string is \"{0}\".", s2) + "\n";
      outputBlock.Text += String.Format("The delimiter string is \"{0}\".\n", stringSeparator[0]) + "\n";

      // Split a string delimited by another string and return all elements.
      outputBlock.Text += String.Format("2b) Split a string delimited by another string and " +
                        "return all elements:") + "\n";
      result = s2.Split(stringSeparator, StringSplitOptions.None);
      Show(outputBlock, result);

      // Split the original string at the delimiter and return all non-empty elements.
      outputBlock.Text += String.Format("2c) Split a string delimited by another string and " +
                        "return all non-empty elements:") + "\n";
      result = s2.Split(stringSeparator, StringSplitOptions.RemoveEmptyEntries);
      Show(outputBlock, result);
   }

   // Display the array of separated strings.
   public static void Show(System.Windows.Controls.TextBlock outputBlock, string[] entries)
   {
      outputBlock.Text += String.Format("The return value contains these {0} elements:", entries.Length) + "\n";
      foreach (string entry in entries)
      {
         outputBlock.Text += String.Format("<{0}>", entry);
      }
      outputBlock.Text += "\n\n";
   }
}
/*
This example produces the following results:

1) Split a string delimited by characters:

1a )The original string is ",ONE,,TWO,,,THREE,,".
The delimiter character is ','.

1b) Split a string delimited by characters and return all elements:
The return value contains these 9 elements:
<><ONE><><TWO><><><THREE><><>

1c) Split a string delimited by characters and return all non-empty elements:
The return value contains these 3 elements:
<ONE><TWO><THREE>

2) Split a string delimited by another string:

2a) The original string is "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]".
The delimiter string is "[stop]".

2b) Split a string delimited by another string and return all elements:
The return value contains these 9 elements:
<><ONE><><TWO><><><THREE><><>

2c) Split a string delimited by another string and return all non-empty elements:
The return value contains these 3 elements:
<ONE><TWO><THREE>

*/


Windows Phone OS

サポート: 8.0

表示:
© 2015 Microsoft