.\"sort an array
.TH sort_array 3
<p>
<h3>NAME</h3>
sort_array() - sort an array
<p>
<h3>SYNOPSIS</h3>
mixed *sort_array( mixed *arr, string fun, object ob );
<p>
<h3>DESCRIPTION</h3>
Returns an array with the same elements as `arr', but quicksorted in
descending order according to the rules in `ob->fun()'.  `ob->fun()' will
be passed two arguments for each call.  It should return -1, 0, or 1,
depending on the relationship of the two arguments (lesser, equal to,
greater than).
<p>
Here are two common forms for the compare function to take:
<pre>
int compare(string one, two) {
    return strcmp(one, two);
}

int compare(int one, two) {
    return (one - two);
}
</pre>