------------------------------------------
PTMDB MODULE - db_drop_database() FUNCTION
------------------------------------------

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

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

    $rv = &db_drop_database($db_object, $db_name);

  -----------
  DESCRIPTION
  -----------

    Removes a database from the server.
    Returns the DROP DATABASE query's return value.
    Returns 0 (zero) if successful.
    Requires the appropriate database permissions.

  ---------
  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.

    $db_name

      REQUIRED

      The name of the database to remove.

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

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

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

    MODULES

      PTMDB

    FUNCTIONS

      PTMDB - db_create_database()