Contents Index Find method FindLast method

UltraLite Static C++ User's Guide
  C++ API Reference
    ULTable class

FindFirst method


Prototype 

bool FindFirst( ul_column_num ncols )

Description 

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

The current index is that used to specify the sort order of the table, It is specified when your application calls the generated table Open method. The default index is the primary key. For more information, see Open method.

To specify the value 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 AfterLast().

Parameters 

ncols    For composite indexes, the number of columns to use in the lookup. For example, if there is a three column index, and you want to lookup a value that matches based on the first column only, you should Set the value for the first column, and then supply an ncols value of 1.

Returns 

true (1) if successful.

false (0) if unsuccessful.

See also 

FindLast method

FindNext method

FindPrevious method

LookupBackward method

LookupForward method


Contents Index Find method FindLast method