Strings.Split メソッド

.NET Framework クラス ライブラリ リファレンス

Strings.Split メソッド

指定された数の部分文字列を含む、インデックス番号が 0 から始まる 1 次元配列を返します。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function Split
 ( _
    Expression As String, _
    <OptionalAttribute> Optional Delimiter As
 String = " ", _
    <OptionalAttribute> Optional Limit As
 Integer = -1, _
    <OptionalAttribute> Optional Compare As
 CompareMethod = CompareMethod.Binary _
) As String()

Visual Basic (使用法)

Dim Expression As String
Dim Delimiter As String
Dim Limit As Integer
Dim Compare As CompareMethod
Dim returnValue As String()

returnValue = Strings.Split(Expression, Delimiter, Limit, Compare)

C#

public static string[] Split
 (
    string Expression,
    [OptionalAttribute] string Delimiter,
    [OptionalAttribute] int Limit,
    [OptionalAttribute] CompareMethod Compare
)

C++

public:
static array<String^>^ Split (
    String^ Expression, 
    [OptionalAttribute] String^ Delimiter, 
    [OptionalAttribute] int Limit, 
    [OptionalAttribute] CompareMethod Compare
)

J#

public static String[] Split (
    String Expression, 
    /** @attribute OptionalAttribute() */ String Delimiter, 
    /** @attribute OptionalAttribute() */ int Limit, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

JScript

public static function Split
 (
    Expression : String, 
    Delimiter : String, 
    Limit : int, 
    Compare : CompareMethod
) : String[]

パラメータ

Expression

必須。部分文字列および区切り記号を含む String 型の式。

Delimiter

省略可能。文字列の区切りを識別するために使用する任意の 1 文字。Delimiter が省略された場合、空白文字 (" ") が区切り記号として使用されます。

Limit

省略可能。入力文字列を分割する場合の部分文字列の最大数。既定値の –1 は、Delimiter 文字列が出現するたびに入力文字列を分割することを示しています。

Compare

省略可能。部分文字列を評価する場合に使用する比較を示す数値。値については、「設定」を参照してください。

戻り値
String 配列。Expression が長さ 0 の文字列 ("") の場合、Split は、長さ 0 の文字列を含む単一要素の配列を返します。Delimiter が長さ 0 の文字列である場合、または Expression に Delimiter がない場合に、Split は Expression 型の文字列を含む単一要素の配列を返します。

解説

詳細については、Visual Basic のトピック「Split 関数 (Visual Basic)」を参照してください。

既定で、または Limit が -1 の場合に、Split 関数は区切り文字列が出現するたびに入力文字列を分割し、配列内の部分文字列を返します。Limit パラメータが 0 よりも大きい場合、Split 関数は、最初に区切り記号の Limit-1 に遭遇した位置で文字列を分割し、結果の部分文字列を含む配列を返します。たとえば、Split("a:b:c", ":") は配列 {"a", "b", "c"} を返し、Split("a:b:c", ":", 2) は配列 {"a", "b:c"} を返します。

Split 関数が 1 行で 2 つの区切り記号に遭遇した場合、または文字列の先頭または末尾で区切り記号に遭遇した場合は、空の文字列 ("") を囲んでいると解釈します。たとえば、Split("xx", "x") は 3 つの空の文字列を含む配列を返します。1 つは文字列の先頭と最初の "x" の間、2 つ目は 2 つの "x" 文字列の間、3 つ目は最後の "x" と文字列の末尾との間です。

次の表に、オプションの Delimiter、Limit、および Compare の各パラメータによって Split 関数の動作を変更する方法を示します。

Split の呼び出し	戻り値
Split("42, 12, 19")	{"42," , "12," , "19"}
Split("42, 12, 19", ", ")	{"42", "12", "19"}
Split("42, 12, 19", ", ", 2)	{"42", "12, 19"}
Split("192.168.0.1", ".")	{"192", "168", "0", "1"}
Split("Alice and Bob", " AND ")	{"Alice and Bob"}
Split("Alice and Bob", " AND ", ,CompareMethod.Text)	{"Alice", "Bob"}
Split("someone@example.com", "@",1)	{"someone@example.com"}
Split("someone@example.com", "@",2)	{"someone", "example.com"}

Compare 引数の設定値は次のとおりです。

定数	説明	値
CompareMethod.Binary	バイナリ比較を実行します。	0
CompareMethod.Text	テキスト比較を実行します。	1

使用例

文字列を空白で分割する方法を次の例に示します。

Visual Basic

Dim TestString As String
 = "Look at these!"
' Returns an array containing "Look", "at", and
 "these!".
Dim TestArray() As String
 = Split(TestString)

複数の文字列記号によって 1 行内の文字列を分割し、空の文字列をフィルタリングする方法を次の例に示します。

Visual Basic

Dim TestString As String
 = "apple    pear banana  "
Dim TestArray() As String
 = Split(TestString)
' TestArray holds {"apple", "", "", "",
 "pear", "banana", "", ""}
Dim LastNonEmpty As Integer
 = -1
For i As Integer = 0 To
 TestArray.Length - 1
    If TestArray(i) <> ""
 Then
        LastNonEmpty += 1
        TestArray(LastNonEmpty) = TestArray(i)
    End If
Next
ReDim Preserve TestArray(LastNonEmpty)
' TestArray now holds {"apple", "pear", "banana"}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Strings クラス
Strings メンバ
Microsoft.VisualBasic 名前空間
その他の技術情報
Split 関数 (Visual Basic)
文字列操作の概要
Join 関数 (Visual Basic)
CompareMethod 列挙型