lsort(3Tcl)

NAME
     lsort - Sort the elements of a list

SYNOPSIS
     lsort ?switches? list


DESCRIPTION
     This command sorts the elements of list, returning a new list in sorted
     order.  By default ASCII sorting is used with the result returned in
     increasing order.  However, any of the following switches may be         |
     specified before list to control the sorting process (unique             |
     abbreviations are accepted):

     -ascii              Use string comparison with ASCII collation order.    |
                         This is the default.

     -integer            Convert list elements to integers and use integer    |
                         comparison.

     -real               Convert list elements to floating-point values and   |
                         use floating comparison.

     -command command    Use command as a comparison command.  To compare two |
                         elements, evaluate a Tcl script consisting of command|
                         with the two elements appended as additional         |
                         arguments.  The script should return an integer less |
                         than, equal to, or greater than zero if the first    |
                         element is to be considered less than, equal to, or  |
                         greater than the second, respectively.

     -increasing         Sort the list in increasing order (``smallest'' items|
                         first).  This is the default.

     -decreasing         Sort the list in decreasing order (``largest'' items |
                         first).


KEYWORDS
     element, list, order, sort