UltraLite User's Guide
C++ API Reference
ULTable class
bool FindFirst( ul_column_num ncols )
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().
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.