programming/netfx/string/1_operations/index.wiki.txt

$samplecode(lang=c#,copyright-year=2020,String.Splitメソッドを使って指定した区切り文字列で文字列を分割する)

#code(code-id=a701ed37-15f3-11eb-ad02-1d3b4b62e371){{

using System;

class Sample {

  static void Main()

  {

    var s = "The quick brown\r\nfox jumps over\r\nthe lazy dog";

    var lines = s.Split("\r\n"); // 改行の文字列"\r\n"を区切りとして文字列sを分割

    foreach (var line in lines) {

      Console.WriteLine(line);

    }

  }

}

}}

$samplecode(lang=vb)

#code(code-id=a7020ca3-15f3-11eb-ad02-1d3b4b62e371){{

Imports System

Class Sample

  Shared Sub Main()

    Dim s As String = "The quick brown" + vbCrLf + "fox jumps over" + vbCrLf + "the lazy dog"

    Dim lines As String() = s.Split(vbCrLf) ' 改行の文字列vbCrLfを区切りとして文字列sを分割

    For Each line As String In lines

      Console.WriteLine(line)

    Next

  End Sub

End Class

}}

$samplecode

#prompt{{

The quick brown

fox jumps over

the lazy dog

}}

$samplecode$

String.Splitメソッドでは、区切りとなる文字または文字列を複数指定することもできます。　この場合、どれか一つに一致する箇所があれば、そこを区切りとして分割が行われます。

$samplecode(lang=c#,copyright-year=2020,String.Splitメソッドを使って複数の区切り文字で文字列を分割する)

#code(code-id=a7020d96-15f3-11eb-ad02-1d3b4b62e371){{

using System;

class Sample {

  static void Main()

  {

    var s = "The quick\nbrown fox\tjumps over\rthe lazy dog";

    var phrases = s.Split(new[] {'\r', '\n', '\t'}); // CR/LF/TABを区切りとして文字列sを分割

    foreach (var phrase in phrases) {

      Console.WriteLine(phrase);

    }

  }

}

}}

$samplecode(lang=vb)

#code(code-id=a7020e04-15f3-11eb-ad02-1d3b4b62e371){{

Imports System

Class Sample

  Shared Sub Main()

    Dim s As String = "The quick" + vbLf + "brown fox" + vbTab + "jumps over" + vbCr + "the lazy dog"

    Dim phrases As String() = s.Split(New Char() { vbCr, vbLf, vbTab }) ' CR/LF/TABを区切りとして文字列sを分割

    For Each phrase As String In phrases

      Console.WriteLine(phrase)

    Next

  End Sub

End Class

}}

$samplecode

#prompt{{

The quick

brown fox

jumps over

the lazy dog

}}

$samplecode$

String.Splitメソッドでは、分割時の動作オプションを&msdn(netfx,type,System.StringSplitOptions){StringSplitOptions};で指定することができます。

StringSplitOptionsでは、分割によって生じる空の要素を除外する[[RemoveEmptyEntries>#StringSplitOptions.RemoveEmptyEntries]]、分割によって生じる前後の空白を削除する[[TrimEntries>#StringSplitOptions.TrimEntries]]を指定することができます。　特に指定しない場合、StringSplitOptions.Noneを指定した場合は、デフォルトの動作となります。

正規表現を用いて分割を行いたい場合は、[[Regex.Splitメソッド>programming/netfx/regex/0_abstract#Regex.Split]]を使用します。

$remarks$

&msdn(netfx,member,System.String.Split){String.Splitメソッド};で&msdn(netfx,member,System.StringSplitOptions.RemoveEmptyEntries){StringSplitOptions.RemoveEmptyEntries};を指定すると、分割によって空の要素(長さ0の部分)が生じた場合に、それを除外することができます。

$samplecode(lang=c#,copyright-year=2016,StringSplitOptions.RemoveEmptyEntriesを指定して空となる要素を除外して文字列を分割する)

    Console.WriteLine();

    Console.WriteLine()

Length = 5

<field1>

<>

<field3>

<field4>

<>

}}

$samplecode$

***前後の空白の削除 (StringSplitOptions.TrimEntries) [#StringSplitOptions.TrimEntries]

&msdn(netfx,member,System.String.Split){String.Splitメソッド};で&msdn(netfx,member,System.StringSplitOptions.TrimEntries){StringSplitOptions.TrimEntries};を指定すると、分割によって各要素の前後に空白が生じる場合に、それを削除することができます。　これは、Splitメソッドで分割した後に個々の要素に対して[[String.Trimメソッド>#String.Trim]]を呼び出し、前後の空白を削除するのと同じ動作となります。

StringSplitOptions.TrimEntriesは.NET 5以降で使用できます。

$samplecode(lang=c#,copyright-year=2020,target-framework=net5,StringSplitOptions.TrimEntriesを指定して各要素の前後の空白を削除して文字列を分割する)

#code(code-id=a70210bf-15f3-11eb-ad02-1d3b4b62e371){{

using System;

class Sample {

  static void Main()

  {

    var s = " field1,   field2 ,field3  "; // カンマ区切りの文字列(各カラムの前後に余白を含む)

    // 文字','を区切りとして分割し、各要素の前後の空白を除去する

    Console.WriteLine($"[{nameof(StringSplitOptions.TrimEntries)}]");

    var fields = s.Split(',', StringSplitOptions.TrimEntries);

    foreach (var field in fields) {

      Console.WriteLine("<{0}>", field);

    }

    Console.WriteLine();

    // 文字','を区切りとして分割する (各要素の前後の空白はそのままにする)

    Console.WriteLine($"[{nameof(StringSplitOptions.None)}]");

    fields = s.Split(',', StringSplitOptions.None);

    foreach (var field in fields) {

      Console.WriteLine("<{0}>", field);

    }

  }

}

}}

$samplecode(lang=vb)

#code(code-id=a7021180-15f3-11eb-ad02-1d3b4b62e371){{

Imports System

Class Sample

  Shared Sub Main()

    Dim s As String = " field1,   field2 ,field3  " ' カンマ区切りの文字列(各カラムの前後に余白を含む)

    Dim fields As String()

    ' 文字','を区切りとして分割し、各要素の前後の空白を除去する

    Console.WriteLine($"[{NameOf(StringSplitOptions.TrimEntries)}]")

    fields = s.Split(","c, StringSplitOptions.TrimEntries)

      Console.WriteLine("<{0}>", field)

    Next

    Console.WriteLine()

    fields = s.Split(","c, StringSplitOptions.None)

    For Each field As String In fields

      Console.WriteLine("<{0}>", field)

    Next

  End Sub

End Class

}}

$samplecode

#prompt{{

[TrimEntries]

<field1>

<field2>

<field3>

[None]

< field1>

<   field2 >

<field3  >

なお、このオプションでは[[String.Trimメソッド>#String.Trim]]と同様に&msdn(netfx,member,System.Char.IsWhiteSpace){Char.IsWhiteSpace};が```true```となる''空白文字''が削除されます。　''空白文字''には改行文字等も含まれます。