UniBasic Commands Reference - Rocket Software

Parameters
The following table describes each parameter of the syntax.
Parameter Description
1-420 UniBasic Commands Reference
element Specifies the string to search for. element can be a variable, array
element, function, or literal.
dyn.array
Specifies a dynamic array and level (attribute, value, or
subvalue) to search. The search operates as follows:
The search begins at the lowest level specified.
Only the specified level is searched.
Returns the position of the located string relative to the
beginning of the search.
1 in attrib.expr causes a search starting with the first attribute in
the file.
0 in any expression is treated as 1.
If the arguments cause the search to begin beyond the end of the
dynamic array, the ELSE clause executes.
See also the LOCATE in BASICTYPEs U, P, and M table.
,var Specifies the attribute, value, or subvalue in the array at which
to begin the search.
BY search.type Selects a type of search appropriate for the physical arrangement
of a sorted array.
AL – Ascending, contents left-justified.
AR – Ascending, contents right-justified.
DL – Descending, contents left-justified.
DR – Descending, contents right-justified.
When UniData first retrieves the data, it sorts the data in the
requested order.
Do not use a BY clause in a LOCATE statement on an unsorted
array. The search could terminate before checking all elements.
UDT.OPTIONS 85 modifies the sort to place negative numbers
first rather than sort them in ASCII order.
LOCATE Parameters