php man page for dbx_sort

DBX_SORT(3)								 1							       DBX_SORT(3)

dbx_sort - Sort a result from a dbx_query by a custom sort function

SYNOPSIS
       bool dbx_sort (object  $result, string  $user_compare_function)

DESCRIPTION
	Sort a result from a dbx_query(3) call with a custom sort function.

PARAMETERS
	      o $result
		- A result set returned by dbx_query(3).

	      o $user_compare_function
		-  The	user-defined  comparison function. It must accept two arguments and return an integer less than, equal to, or greater than
		zero if the first argument is considered to be respectively less than, equal to, or greater than the second.

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

EXAMPLES
       Example #1

	      dbx_sort(3) example

	      <?php
	      function user_re_order($a, $b)
	      {
		  $rv = dbx_compare($a, $b, "parentid", DBX_CMP_DESC);
		  if (!$rv) {
		      $rv = dbx_compare($a, $b, "id", DBX_CMP_NUMBER);
		  }
		  return $rv;
	      }

	      $link   = dbx_connect(DBX_ODBC, "", "db", "username", "password")
		  or die("Could not connect");

	      $result = dbx_query($link, "SELECT id, parentid, description FROM tbl ORDER BY id");
		  // data in $result is now ordered by id

	      dbx_sort($result, "user_re_order");
		  // data in $result is now ordered by parentid (descending), then by id

	      dbx_close($link);
	      ?>

NOTES
       Note

	       It is always better to use ORDER BY SQL clause instead of dbx_sort(3) if possible.

SEE ALSO
       dbx_compare(3).

PHP Documentation Group 													       DBX_SORT(3)