Updated: September 2009
Returns a zero-based, one-dimensional array containing a specified number of substrings.
Split(expression[, delimiter[, count[, compare]]])
- expression
Required. String expression containing substrings and delimiters. If expression is a zero-length string, Split returns an empty array, that is, an array with no elements and no data.
- delimiter
Optional. String used to identify substring limits. If omitted, the space character (" ") is assumed to be the delimiter. If delimiter is a zero-length string, a single-element array containing the entire expression string is returned.
- count
Optional. Number of substrings to be returned; -1 indicates that all substrings are returned. If omitted, all substrings are returned.
- compare
Optional. Numeric value indicating the kind of comparison to use when evaluating substrings. See Settings section for values. If omitted, a binary comparison is performed.
The compare argument can have the following values:
Constant | Value | Description |
|---|
vbBinaryCompare | 0 | Perform a binary comparison. |
vbTextCompare | 1 | Perform a textual comparison. |
The following example uses the Split function to fill an array from a string that uses "|" as a delimiter.
Dim MyString, MyArray, i
MyString = "VBScript|is|fun!"
MyArray = Split(MyString, "|", -1, 1)
' MyArray(0) contains "VBScript".
' MyArray(1) contains "is".
' MyArray(2) contains "fun!".
For i = 0 to UBound(MyArray)
MsgBox (MyArray(i))
Next
Version 2
Reference
Date | History | Reason |
|---|
September 2009
| Added information about the count and compare arguments. |
Customer feedback.
|
April 2009
| Modified description for delimiter argument. |
Customer feedback.
|
March 2009
| Modified example. |
Information enhancement.
|