Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

list (1t)

Name

list - Create a list

Synopsis

list ?arg arg ...?

Description

list(1t)                     Tcl Built-In Commands                    list(1t)



______________________________________________________________________________

NAME
       list - Create a list

SYNOPSIS
       list ?arg arg ...?
______________________________________________________________________________

DESCRIPTION
       This  command  returns  a  list  comprised of all the args, or an empty
       string if no args are specified.  Braces and backslashes get  added  as
       necessary,  so that the lindex command may be used on the result to re-
       extract the original arguments, and also so that eval may  be  used  to
       execute the resulting list, with arg1 comprising the command's name and
       the other args comprising its arguments.  List produces  slightly  dif-
       ferent  results  than  concat:   concat  removes  one level of grouping
       before forming the list, while list works directly  from  the  original
       arguments.

EXAMPLE
       The command

              list a b "c d e  " "  f {g h}"

       will return

              a b {c d e  } {  f {g h}}

       while concat with the same arguments will return

              a b c d e f {g h}


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tcl-8    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       lappend(n),  lindex(n),  linsert(n), llength(n), lrange(n), lrepeat(n),
       lreplace(n), lsearch(n), lset(n), lsort(n)

KEYWORDS
       element, list, quoting



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded from  http://prdownloads.sourceforge.net/tcl/tcl-
       core8.6.7-src.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tcl                                                                   list(1t)