Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

join (1t)

Name

join - Create a string by joining together list elements

Synopsis

join list ?joinString?

Description

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



______________________________________________________________________________

NAME
       join - Create a string by joining together list elements

SYNOPSIS
       join list ?joinString?
______________________________________________________________________________

DESCRIPTION
       The  list  argument must be a valid Tcl list.  This command returns the
       string formed by joining all of the  elements  of  list  together  with
       joinString  separating  each adjacent pair of elements.  The joinString
       argument defaults to a space character.

EXAMPLES
       Making a comma-separated list:

              set data {1 2 3 4 5}
              join $data ", "
                   -> 1, 2, 3, 4, 5

       Using join to flatten a list by a single level:

              set data {1 {2 3} 4 {5 {6 7} 8}}
              join $data
                   -> 1 2 3 4 5 {6 7} 8


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


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

SEE ALSO
       list(n), lappend(n), split(n)

KEYWORDS
       element, join, list, separator



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                                                                   join(1t)