Apply the search criteria provided after a previous call to Table::begin_seek.
- Returns:
-
- Precondition:
- The table is in DB_TABLE_SEEKING mode.
- Postcondition:
- The table is in DB_TABLE_BROWSING mode, unless the search criteria was invalid. Call cancel to return to browsing mode in case of an error.
To search for a row in the table using an index:
- Call set_sort_order to select the index whose fields should be used to perform the search.
- Call begin_seek
- Call set_field one or more times to set a value for each field in the index.
- Call apply_seek to position the cursor on the first record matching the values given to set_field.
If DB_SEEK_EQUAL is used, the current record will be the first row whose index field matches the key.
- See also:
- begin_seek, set_field