--------------------------------------------
PTMDB MODULE - db_delete_row_like() FUNCTION
--------------------------------------------

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

    Where $ret is a return value of 1 or 0 (zero):

    $ret = &db_delete_row_like($db_object, $table, $column, $value);

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

    Removes a row from a given database table based on a `column` LIKE 'value'
    comparison match. Use caution when using this function as all matched
    rows will be removed from your database table. Ensure that you use the
    most precise match comparisons possible.
    Returns 1 if successful.
    Returns 0 (zero) if not 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

      REQUIRED

      The name of the table from which you would like to remove row information.

    $column

      REQUIRED

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

    $value

      REQUIRED

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

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

    1 if row(s) was/were deleted successfully
    0 (zero) if deletion was not successful or if no rows were matched.

  --------------
  USAGE EXAMPLES
  --------------

    ------------------------------------------------------------------
    Example 1: Remove Rows from 'MyTable' Where 'name' Begins with 'M'
    ------------------------------------------------------------------

      <? $ret = &db_delete_row_like($dbobj, 'MyTable', 'name', 'm%'); ?>

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

    MODULES

      PTMDB

    FUNCTIONS

      PTMDB - db_connect()
      PTMDB - db_delete_row()
      PTMDB - db_delete_row_where()