UltraLite User's Guide
C++ API Reference
ULTable class
bool LookupForward( ul_column_num ncols )
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().
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.
true (1) if successful.
false (0) if unsuccessful.