Split

From Xojo Documentation

Global Method

Split(values As String, delimiter As String) As String()

Supported for all project types and targets.

Creates a one-dimensional array from the String passed.


Method

String.Split(delimiter As String) As String()

Supported for all project types and targets.

Creates a one-dimensional array from the String.

Usage

result = Split(source [,delimiter])
Or
source.Split([delimiter])

Part Type Description
result String array Array resulting from breaking source into elements using delimiter as the field delimiter.
source String Source string to be parsed into an array.
delimiter String Optional field delimiter used to parse Source into array elements. If delimiter is omitted, then a space is used as the delimiter.

Notes

Use the Split function to create a new String array from a list of elements (or fields) that are separated by a delimiter. If the optional parameter, delimiter, is not passed, a single space is assumed as the delimiter. If the delimiter is an empty string, the source string is split into characters.

Sample Code

The section of code specifies the comma delimiter and the second uses the default delimiter. They place each field into an array element, producing a three-element array. The last code section parses the string into individual characters.

Dim anArray(-1) As String
// Use as global methods
anArray = Split("Adam,Aardvark,Accountant", ",")
anArray = Split("Adam Aardvark Accountant")
anArray = Split("Adam", "")

// Use as String methods
Dim s As String
s = "Adam,Aardvark,Accountant"
anArray = s.Split(",") // produces 3-element array
anArray = s.Split("") // produces array of individual characters, but should be avoided

See Also

String data type; Dim statement; Array, Join, NthField, SplitB, Ubound functions; Append, IndexOf, Insert, Pop, Redim, Remove, Shuffle, Sort, Sortwith methods; ParamArray keyword, Arrays topic