db_row_t db_alloc_row ( const db_bind_t binds,
db_fieldno_t  nfields 
)

Allocate a row using absolute or relative bindings.

Parameters:
binds Array of bindings.
nfields Number of fields in binds.
Returns:
  • Row handle.
  • NULL on failure.
On failure, one of the following error codes is set:
  • DB_EINVAL Caused by: number of fields being bound is 0, binding structure is not valid.
  • DB_EBINDSIZE Invalid bind size. Data type and size don't match.

See also:
db_free_row,
get_db_error, clear_db_error, Error Handling


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