db_result_t db_insert ( db_cursor_t  hcursor,
db_row_t  hrow,
db_object_t  uobject,
db_flags_t  flags 
)

Insert the data in hrow into the table represented by the cursor and position the cursor on the inserted row.

Parameters:
hcursor Cursor handle.
hrow Row of values for insert. Unbound fields will be treated as null.
uobject Row data for relative bindings. Use NULL if hrow does not contain relative bindings.
flags Post positioning flag
  • DB_INSERT_SEEK_NEW - seek to the newly inserted record.
  • 0 - stay at the current record whatever it is.
Returns:
On failure, one of the following error codes is set:
  • DB_EINVAL Caused by: invalid cursor handle, invalid row handle.
  • DB_ESTATE The cursor does not support insert operations.

See also:
db_fetch, db_update, db_delete,
get_db_error, clear_db_error, Error Handling


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