----------------------------------------------------------------------
sort                                                             (Lib)
----------------------------------------------------------------------
sort : ('a -> 'a -> bool) -> 'a list -> 'a list

SYNOPSIS
Sorts a list using a given transitive ‘ordering’ relation.

DESCRIBE
The call {sort opr list} where {opr} is a curried transitive relation
on the elements of {list}, will sort the list, i.e., will permute {list}
such that if {x opr y} but not {y opr x} then {x} will
occur to the left of {y} in the sorted list. In particular if {opr} is
a total order, the result list will be sorted in the usual sense of the
word.

FAILURE
Never fails.

EXAMPLE
A simple example is:

   - sort (curry (op<)) [3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5, 8, 9, 7, 9];
   > val it = [1, 1, 2, 3, 3, 4, 5, 5, 5, 6, 7, 8, 9, 9, 9] : int list

The following example is a little more complicated. Note
that the ‘ordering’ is not antisymmetric.

   - sort (curry (op< o (fst ## fst)))
          [(1,3), (7,11), (3,2), (3,4), (7,2), (5,1)];
   > val it = [(1,3), (3,4), (3,2), (5,1), (7,2), (7,11)] : (int * int) list




COMMENTS
The Standard ML Basis Library also provides implementations of sorting.

SEEALSO
Lib.int_sort, Lib.topsort.

----------------------------------------------------------------------