Xojo Documentation Xojo Documentation

Method

Creates a one-dimensional array from the String.

Usage

result = source.ToArray([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 ToArray 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, an array of characters is created from the source string.

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.

Var anArray(-1) As String
Var s As String
s = "Adam,Aardvark,Accountant"
anArray = s.ToArray(",") // produces 3-element array
anArray = s.ToArray("") // produces array of individual characters

See Also

String data type; Arrays concept