------------------------------------------
PTMDB MODULE - db_get_row_count() FUNCTION
------------------------------------------

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

    Where $count is the returned number of rows:

    $count = &db_get_row_count($db_object, $table_name);
    $count = &db_get_row_count($db_object, $table_name, $column, $value);

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

    Returns the number of rows in a given database table. Optionally, can
    return only the number of rows that match a given `column` = 'value'
    comparison. Set $column and $value to use this comparison option.

  ---------
  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 from which you would like to pull row information.

    $column

      OPTIONAL

      The column name to use in a `column` = 'value' test comparison.

    $value

      OPTIONAL / REQUIRED

      Only required if $column is specified -- The value to use in a
      `column` = 'value' comparison.

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

    The number of rows in the given database table, optionally returning only
    the number of `column` = 'value' comparison matches.

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

    MODULES

      PTMDB

    FUNCTIONS

      PTMDB - db_select_database()
      PTMDB - db_get_row_count_like()
      PTMDB - db_get_row_count_where()