NAME
Tcl_Concat - concatenate a collection of strings
SYNOPSIS
#include <tcl.h>
char *
Tcl_Concat(argc, argv)
ARGUMENTS
int argc (in) Number of
strings.
char *argv[] (in) Array of strings
to concatenate.
Must have argc
entries.
_________________________________________________________________
DESCRIPTION
Tcl_Concat is a utility procedure used by several of the
Tcl commands. Given a collection of strings, it concate
nates them together into a single string, with the origi
nal strings separated by spaces. This procedure behaves
differently than Tcl_Merge, in that the arguments are sim
ply concatenated: no effort is made to ensure proper list
structure. However, in most common usage the arguments
will all be proper lists themselves; if this is true,
then the result will also have proper list structure.
Tcl_Concat eliminates leading and trailing white space as
it copies strings from argv to the result. If an element
of argv consists of nothing but white space, then that
string is ignored entirely. This white-space removal was
added to make the output of the concat command cleaner-
looking.
The result string is dynamically allocated using |
Tcl_Alloc; the caller must eventually release the space |
by calling Tcl_Free. |
SEE ALSO |
Tcl_ConcatObj |
KEYWORDS |
concatenate, strings |
Man(1) output converted with
man2html