MAT SEARCH

Searches an array for user specified conditions.
 
 MAT SEARCH numeric-array [num-key], rule; return [,start]
MAT SEARCH string-array$ [str-key], rule; return [,start]
 
Usage:
MAT SEARCH Vector,#LOC(<>PI);Not_pi
MAT SEARCH Temperature,LOC MAX;Hottest
MAT SEARCH Students,LOC(<.33);Flunk,4
MAT SEARCH Titles$(*,2,3) DES,MAX;Last_book$
MAT SEARCH Array$(*), LOC(=Target$);I
 
Example: MAT SEARCH.BAS
 
Description:
A numeric or string array is searched for the specified condition and the result is returned in the return variable. The keyword DES specifies descending search order. The optional start value specifies the starting subscript. If not specified, searching begins with the first element for ascending searches and the last element for descending searches. The "rule" specifies the search rules to use and what to return:        
 
Rule
Meaning
LOC
Subscript of first element satisfying operator
#LOC
Count the number of elements satisfying operator
LOC MAX
Subscript of maximum value
LOC MIN
Subscript of minimum value
MAX
Find and return the maximum value
MIN
Find and return the minimum value
 
COMPLEX Arrays
MAT SEARCH can search an array, but since the concept of linear ordering does not apply to the complex plane, greater than, less than, MIN and MAX operations are not allowed.
 
See Also:
MAT, MAT REORDER, MAT SORT, REDIM