Cursor

db_bof db_close_cursor db_cursor_t db_delete db_duplicate_cursor db_eof db_fetch db_find_field db_get_bookmark db_get_cursor_flags db_get_field db_get_field_count db_goto_bookmark db_insert db_open_table_cursor db_qfetch db_qinsert db_qseek db_qupdate db_seek db_seek_first db_seek_last db_seek_next db_seek_prior db_set_range db_table_cursor_destroy db_table_cursor_init db_update

db_result_t db_qinsert ( db_cursor_t  hcursor, const db_bind_t *  binds, db_len_t  nbinds, db_object_t  uobject, db_flags_t  flags   ) Insert a new row into a cursor's table using a binding array. db_qinsert is a convenience function that combines db_alloc_row and db_insert. For best performance in tight loops, use db_alloc_row outside the loop and db_insert inside the loop. Postcondition: The cursor is positioned on the inserted row. Parameters: hcursor  Cursor handle. binds  Array of bindings. nfields  Number of fields in binds. uobject  Row data for relative bindings. Use NULL if hrow does not contain relative bindings. flags  DB_INSERT_SEEK_NEW - seek to the newly inserted record. 0 - stay at the current record whatever it is. Returns: DB_OK when successful. DB_FAIL on failure. On failure, one of the following error codes is set: DB_EINVAL Caused by: invalid cursor, relative field binding is null. DB_EBINDSIZE Invalid bind size DB_ERANGE Argument is out of range. Number of fields < 0 or number of fields > binds.size. DB_ENAME Invalid field name used in binding. DB_ESTATE The cursor does not support insert operations. See also: get_db_error, clear_db_error, Error Handling