Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

concat (1t)

Name

concat - Join lists together

Synopsis

concat ?arg arg ...?

Description

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



______________________________________________________________________________

NAME
       concat - Join lists together

SYNOPSIS
       concat ?arg arg ...?
______________________________________________________________________________

DESCRIPTION
       This  command  joins  each  of its arguments together with spaces after
       trimming leading and trailing white-space from each of them.  If all of
       the arguments are lists, this has the same effect as concatenating them
       into a single list.  Arguments that  are  empty  (after  trimming)  are
       ignored  entirely.   It permits any number of arguments; if no args are
       supplied, the result is an empty string.

EXAMPLES
       Although concat will concatenate lists, flattening them in the  process
       (so giving the following interactive session):

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

       it will also concatenate things that are not lists, as can be seen from
       this session:

              % concat " a b {c   " d "  e} f"
              a b {c d e} f

       Note also that the concatenation does not remove spaces from the middle
       of values, as can be seen here:

              % concat "a   b   c" { d e f }
              a   b   c d e f

       (i.e., there are three spaces between each of the a, the b and the c).


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


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

SEE ALSO
       append(n), eval(n), join(n)

KEYWORDS
       concatenate, join, list



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