tcl_concat(3)
NAME
Tcl_Concat - concatenate a collection of strings
SYNOPSIS
#include <tcl.h> CONST char * Tcl_Concat(argc, argv)
ARGUMENTS
- int argc (in) Number of
- strings.
- CONST char * CONST 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 cleanerlooking.
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