From Xojo Documentation
|You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!|
| This item was deprecated in version 2019r2.
Please use String.SplitBytes as a replacement.
|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.|
Use the SplitB 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.
According to <feedback://showreport?report_id=16190>, SplitB may not work in all cases as documented here. For instance, if the application is localized for Japanese, SplitB returns an empty array when splitting by an empty string. To be on the safe side until this has been fixed, consider assigning the string to a MemoryBlock variable and access its bytes through that instead.
The first example specifies the comma delimiter and the second example uses the default delimiter. They place each field into an array element, producing a three-element array. The last example parses the string into individual characters.
anArray = SplitB("Adam,Aardvark,Accountant", ",")
anArray = SplitB("Adam Aardvark Accountant")
anArray = SplitB("Adam", "")
// First two using the alternate syntax:
Dim s As String
s = "Adam,Aardvark,Accountant"
anArray = s.SplitB(",") // produces 3-element array
anArray = s.SplitB("") // produces array of individual characters, but should be avoided for some encodings such as Japanese
String data type; Dim statement; Array, CountFieldsB, Join, NthFieldB, Ubound functions; Append, IndexOf, Insert, Pop, Redim, Remove, Shuffle, Sort, Sortwith methods; ParamArray keyword; Arrays concept