FindStrings()

Summary

Finds strings in an array that match one or more search specs.

 

Syntax

a = FindStrings(array input_array, array specs_array, array options)

 

Argument	Contents
input_array	An array of strings to be searched
specs_array	An array of search specs, each an array of one or more search strings

 

No options are currently supported.

 

Returns

An array with an index (0 if not found) for each search spec, even if input_array is null, or null if specs_array is null.

 

Notes

• Each search string must start with "=" for an exact match, "<" to match the start of the string, or ">" to match any part of the string.

• The search strings in a search spec are tried one by one on each string in input_array. The index is returned for the first string in input_array that matches any of the search strings.

• If no string in input_array matches any of the search strings in a search spec, the index 0 is returned for that search spec.

• All comparisons are case-insensitive.

• FindStrings() does not search nested arrays.

 

Example

result = FindStrings({"alpha", "zipcode", "zip"},

     { {"<z", ">a"}, {"=gamma", "<code", "=AlpHa"} }, )

// result = { 2, 1}

 

Error Codes

No error will be returned.

 

See Also

Function	Summary
ArrayPosition()	Finds the position of a sub-array in an array
Subarray()	Extracts a number of elements from an array