KCML_Search_Record

Purpose

Search an array of records by given key and search value

Definition

DEFSUB 'KCML_Search_Record(BYREF Array$(), BYREF Key$()_KCML_SEARCH_REC_KEY), BYREF Search$, BYREF Locator()) AS Numeric

Parameters

Array	Array of records to be searched
Key	Key - an array of key segments
Search	Search - record to search for
Locator	Locator array containing indices, redimmed to number of records found

Description

This function searches an array of records using the given key and search value, returning an array of indices into the record array. The key array contains zero or more key segments. Each segment specifies the start and length. The Locator() array is redimmed to the number of elements found and its values are the indicies into the record array.