int db::Table::apply_seek (  ) 

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:

  1. Call set_sort_order to select the index whose fields should be used to perform the search.
  2. Call begin_seek
  3. Call set_field one or more times to set a value for each field in the index.
  4. 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


Copyright © 2005-2008 ITTIA®. All rights reserved.