int db::Database::drop_table ( const NameChar *  table_name  ) 

Drop a table from the database.

Parameters:
table_name Name of the table to drop.
Returns:
  • DB_NOERROR When successful.
  • DB_ENAME table_name is not in a valid format. Valid name is letter(aA-zZ)+zero or more aplhanumeric characters. Underscore is considered a valid character.
  • DB_ELOCKED Unable to acquire lock.
  • DB_EINTERNAL Internal error detected. Storage was null.
  • DB_EIO I/O error.
  • DB_ESTATE Database has not been opened.
  • DB_ETXSTATE drop_table was called during an active transaction.
Note:
Do not call this function while a transaction is active. If necessary, call tx_commit or tx_abort to finish the current transaction. This function is not atomic.
See also:
Table


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