db_result_t db_create_table ( db_t  hdb,
const db_objname_t table,
const db_tabledef_t param,
db_flags_t  flags 
)

Create a table in a database using a table schema definition.

Parameters:
hdb Database handle.
table Table name. A name must start with a letter and can be followed by one or more letters, numbers, or underscores.
param Table definition parameters. Field names must start with a letter and can be followed by one or more letters, numbers, or underscores.
flags Reserved for future use. Set to zero.
Returns:
On failure, one of the following error codes is set:
  • DB_EINVAL Caused by: invalid database handle, table name is null, table definition is null, fields in table definition is null, field count in table definition <=0. .
  • DB_ENAME Table name is not in a valid format.
  • DB_EFIELD Invalid field name.
  • DB_ERECORDSIZE Record size too large for chosen page size.
  • DB_EDUPLICATE Table with given name already exists.

See also:
db_drop_table,
get_db_error, clear_db_error, Error Handling


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