findFirstForColumns method

Move forward through the table from the beginning, looking for a row that exactly matches a value or partial set of values in the current index.

Syntax
Boolean findFirstForColumns(
  UInt16 numColumns
)
Parameters
  • numColumns   For composite indexes, the number of columns to use in the lookup. For example, if you have a three column index, and you want to look up a value that matches based on the first column only, you should set the value for the first column, and then supply a numColumns value of 1.

Returns

true if successful, false otherwise

Remarks

To specify the value for which to search for, set the column value for each column in the index. The cursor is left on the first row that exactly matches the index value. On failure the cursor position is after the last row (isEOF).

Each search must be preceded by a call to the findBegin method.

See also