Contents Index LookupBackward method Generated result set class

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

LookupForward method


Prototype 

bool  LookupForward( ul_column_num ncols  )

Description 

Move forward through the table starting from the beginning, looking for the first row that matches or is greater than 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 matches or is greater than the index value. On failure (that is, if no rows are greater than the value being looked for), 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

FindNext method

FindPrevious method

LookupBackward method


Contents Index LookupBackward method Generated result set class