Copyright (c) 1993 The Regents of the University of California.
Copyright (c) 1994-1996 Sun Microsystems, Inc.

See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.

RCS: @(#) $Id: concat.n,v 1.11.2.1 2009/04/27 12:35:01 dkf Exp $

.so man.macros S Note: do not modify the .SH NAME line immediately below!
concat - Join lists together concat ?arg arg ...? E

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

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

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

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

.CS % concat " a b {c " d " e} f" a b {c d e} f .CE

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

.CS % concat "a b c" { d e f } a b c d e f .CE

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

append(n), eval(n), join(n) concatenate, join, lists