Contents Index FindLast method FindPrevious method pdf/preface.pdf

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

FindNext method


Prototype 

bool FindNext( ul_column_num ncols )

Description 

Move forwards through the table from the current position, 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 found 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 

FindFirst method

FindLast method

FindPrevious method

LookupBackward method

LookupForward method


Contents Index FindLast method FindPrevious method pdf/preface.pdf