---------------------------------------
PTMDB MODULE - db_drop_table() FUNCTION
---------------------------------------

  ------------
  USAGE FORMAT
  ------------

    Where $rv is the SQL query's return value:

    $rv = &db_drop_table($db_object, $table_name);
    
  -----------
  DESCRIPTION
  -----------

    Removes a table from the selected database. A database MUST be selected
    before calling this function.
    Returns the DROP TABLE query's return value (0 [zero] if successful).

  ---------
  ARGUMENTS
  ---------

    $db_object

      REQUIRED

      A database handler object. This object stores connection information and
      is returned from a db_connect() function call. This object is of the same
      type as is returned by a DBI->connect function call.

   $table_name

      REQUIRED

      The name of the table to remove.

  -------
  RETURNS
  -------

    0 (zero) if successful.
    Nothing if not successful.

  --------
  SEE ALSO
  --------

    MODULES

      PTMDB

    FUNCTIONS

      PTMDB - db_create_table()