• Split

StringArray = Split ( String [ , Separators , Escape , IgnoreVoid , KeepEscape ] )

文字列を区切り文字とエスケープ文字で区切られた部分文字列に分割します。

1. Stringは分割する文字列です。
2. 区切り文字は区切り文字のリストです。
3. エスケープはエスケープ文字です。 2つのエスケープ文字で囲まれた区切り文字は、分割処理では無視されます。 Escapeに2文字が含まれている場合、最初の文字は開始エスケープ文字、2番目の文字は終了文字です。
4. IgnoreVoidは、void要素を返さないようにSplit（）に指示するブール値です。
5. KeepEscapeは、返された文字列内で検出されたエスケープ文字を保持するように指示するブール値です。

この関数は、検出された各部分文字列で埋められた文字列配列を返します。 区切り文字とエスケープ文字は返されません。
デフォルトでは、コンマ文字は区切り文字であり、エスケープ文字はありません。

 

文字列にエスケープ文字が含まれている場合、これらのエスケープ文字は重複している必要があります。

 

区切り文字とエスケープ文字は、単一の1バイトASCII文字です。 この関数を使用して、非ASCII文字または別の文字列で文字列を分割することはできません。 たとえば、Split（MyString、 "\ r \ n"）は、 "\ r"または "\ n"を区切り文字として使用してMyStringを分割しますが、完全な文字列 "\ r \ n"は使用しません。

Examples

Dim Elt As String[]
Dim Sb As String

Elt = Split(" Gambas Almost Means BASIC !\n'Do you agree ?'", " \n", "'")

For Each Sb In Elt
Print "("; Sb; ") ";
Next
Print

() (Gambas) (Almost) (Means) (BASIC) () (!) (Do you agree ?)

 

Dim Elt As String[]
Dim Sb As String

Elt = Split(" Gambas Almost Means BASIC !\n'Do you agree ?'", " \n", "'", True)

For Each Sb In Elt
Print "("; Sb; ") ";
Next
Print

(Gambas) (Almost) (Means) (BASIC) (!) (Do you agree ?)

 

Dim Elt As String[]
Dim Sb As String

Elt = Split("(Gambas) (Almost) (Means) (BASIC) (!) (Do you agree ?)", " ", "()")

For Each Sb In Elt
Print Sb; ".";
Next
Print

Gambas.Almost.Means.BASIC.!.Do you agree ?.

See also

• String Functions