MongoCursor::sort

Sorts the results by given fields

&reftitle.description; public `MongoCursor` `MongoCursor::sort` `array` `fields`
&reftitle.parameters;

`fields`

- An array of fields by which to sort. Each element in the array has as key the field name, and as value either `1` for ascending sort, or `-1` for descending sort.

  Each result is first sorted on the first field in the array, then (if it exists) on the second field in the array, etc. This means that the order of the fields in the `fields` array is important. See also the examples section.

&reftitle.returnvalues;

Returns the same cursor that this method was called on.

&reftitle.errors;

Throws `MongoCursorException` if this cursor has started iterating.

&reftitle.examples;

### `MongoCursor::sort` example

    <?php
    // Sort on field x, ascending
    $cursor->sort(array('x' => 1));

    // The order in the associative array is important. For instance, these two
    // examples will yield different results:

    // Sort on date ascending and age descending
    $cursor->sort(array('date' => 1, 'age' => -1));

    // Sort on age descending and date ascending
    $cursor->sort(array('age' => -1, 'date' => 1));
    ?>