Specifications
Section 11. String Functions
11-5
Remarks
The Start and Length parameters are used to determine which part of the
SearchString is returned. Regardless of the value of the Length parameter, the
returned string will be no longer than the original string.
Parameter
& Data Type
Enter
SearchString
String or
Variable
The string to evaluate for the FilterString.
Start
Integer
An integer that specifies where in the SearchString to begin the operation. A 1
indicates the first character in the string...
Length
Integer
An integer that specifies the maximum number of characters returned by the
instruction..
SplitStr (ResultString, SearchString, FilterString, NumSplit, SplitOption)
The SplitStr instruction is used to return an array of strings or numerics from a
search string.
Syntax
SplitStr ( ResultString, SearchString, FilterString, NumSplit, SplitOption )
Remarks
The FilterString and SplitOption help to define the array returned by the
SplitStr instruction.
Parameter
& Data Type
Enter
ResultString
Variable Array
An array in which the split string will be stored.
SearchString
String or
Variable
The string to evaluate.
FilterString
String or
Variable
Provides a filter for the string(s) to be returned.
NumSplit
Constant
Defines the maximum number of strings or values returned by the instruction.
SplitOption
Constant
A code used to specify the method of splitting the string.
Numeric
Code
Description
0 NUMERIC - Numerics in the SearchString (FilterString is
ignored)
1 NON-NUMERIC - Non-numerics (FilterString is ignored)
2 SEARCHSTRING - Each FilterString in SearchString
3 SEARCHCHARS - Each occurrence of any character that
is in FilterString
4 HEADERFILTER - Strings succeeding FilterString
6 HEADERFILTERCHARS - Strings succeeding any
character in the FilterString char list
8 NUMERICHEX - Hexadecimal numerics in the
SearchString (FilterString is ignored
1x Right justify the resultant array, filling vacant elements
with NAN (if numeric) or a NULL string if a string.