tcl/doc/concat.n

   1 '\"
   2 '\" Copyright (c) 1993 The Regents of the University of California.
   3 '\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
   4 '\"
   5 '\" See the file "license.terms" for information on usage and redistribution
   6 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
   7 '\"
   8 '\" RCS: @(#) $Id$
   9 '\"
  10 .so man.macros
  11 .TH concat n 8.3 Tcl "Tcl Built-In Commands"
  12 .BS
  13 '\" Note:  do not modify the .SH NAME line immediately below!
  14 .SH NAME
  15 concat \- Join lists together
  16 .SH SYNOPSIS
  17 \fBconcat\fI \fR?\fIarg arg ...\fR?
  18 .BE
  19
  20 .SH DESCRIPTION
  21 .PP
  22 This command joins each of its arguments together with spaces after
  23 trimming leading and trailing spaces from each of them.  If all the
  24 arguments are lists, this has the same effect as concatenating them
  25 into a single list.
  26 It permits any number of arguments.  For example, the command
  27 .CS
  28 \fBconcat a b {c d e} {f {g h}}\fR
  29 .CE
  30 will return
  31 .CS
  32 \fBa b c d e f {g h}\fR
  33 .CE
  34 as its result, and
  35 .CS
  36 \fBconcat " a b {c   " d "  e} f"\fR
  37 .CE
  38 will return
  39 .CS
  40 \fBa b {c d e} f\fR
  41 .CE
  42 as its result.
  43 .PP
  44 If no \fIarg\fRs are supplied, the result is an empty string.
  45
  46 .SH "SEE ALSO"
  47 append(n), eval(n)
  48
  49 .SH KEYWORDS
  50 concatenate, join, lists