tcl7.6 User Commands - lsort






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 con-
     trol  the  sorting   process   (unique   abbreviations   are
     accepted):

     -ascii               Use string comparison with ASCII colla-
                         tion 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