db_cursor_t db_duplicate_cursor ( db_cursor_t  hcursor,
db_flags_t  flags 
)

Duplicate a cursor.

Both cursors reference the same data, but can have different positions and flags. Both cursors must be closed using db_close_cursor when no longer needed.

Parameters:
hcursor Cursor handle.
flags Duplication options.
Returns:
  • Handle to duplicate of given cursor.
  • NULL on failure.
On failure, one of the following error codes is set:

See also:
db_close_cursor, db_get_cursor_flags,
get_db_error, clear_db_error, Error Handling


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