distrib/share/tcl/help/tcl/lists/list

   1 NAME
   2        list - Create a list
   3
   4 SYNOPSIS
   5        list ?arg arg ...?
   6
   7
   8 DESCRIPTION
   9        This  command  returns  a  list  comprised of all the args, or an empty
  10        string if no args are specified.  Braces and backslashes get  added  as
  11        necessary,  so that the lindex command may be used on the result to re-
  12        extract the original arguments, and also so that eval may  be  used  to
  13        execute the resulting list, with arg1 comprising the command's name and
  14        the other args comprising its arguments.  List produces  slightly  dif-
  15        ferent  results  than  concat:   concat  removes  one level of grouping
  16        before forming the list, while list works directly  from  the  original
  17        arguments.
  18
  19 EXAMPLE
  20        The command
  21               list a b "c d e  " "  f {g h}"
  22        will return
  23               a b {c d e  } {  f {g h}}
  24        while concat with the same arguments will return
  25               a b c d e f {g h}
  26
  27
  28 SEE ALSO
  29        lappend(n),  lindex(n), linsert(n), llength(n), lrange(n), lreplace(n),
  30        lsearch(n), lset(n), lsort(n)
  31
  32
  33 KEYWORDS