Method
SplitB
Warning
This item was deprecated in version 2019r2. Please use String.SplitBytes as a replacement.
Description
Creates a one-dimensional array from the String passed. SplitB is identical to String, except that it treats the source as binary data.
Usage
result=SplitB(source[,delimiter])
OR
source.SplitB([delimiter])
Part |
Type |
Description |
---|---|---|
result |
String array |
Array resulting from breaking source into elements using delimiter as the field delimiter. |
source |
Source string to be parsed into an array. |
|
delimiter |
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 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 issue 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.
Sample code
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.
Dim anArray(-1) As String
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
Compatibility
All project types on all supported operating systems.
See also
String data type; Dim statement; Array, MemoryBlock, String, MemoryBlock, Arrays functions; Arrays, Arrays.IndexOf, Arrays, Arrays.Pop, Redim, Arrays, Shuffle, Sort, Arrays.Sortwith methods; ParamArray keyword; Arrays concept