db_result_t db_seek_prior ( db_cursor_t  hcursor  ) 

Move the cursor to the previous row in the table.

Parameters:
hcursor Cursor handle.
Returns:
Note:
If the cursor is on the first row in the table and db_seek_prior is called, the cursor will not have a current row and db_bof will return true.
On failure, one of the following error codes is set:
  • DB_EINVAL Cursor handle is invalid.
  • DB_ESTATE Cursor does not support backward scanning.
  • DB_ENOMOREDATA Cursor is already positioned before the beginning of the table.

See also:
db_seek_next, db_seek_first, db_seek_last,
get_db_error, clear_db_error, Error Handling


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