Provided by: tcl8.5-doc_8.5.15-2ubuntu1_all bug

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 concatenates them together into a single string, with the original strings
       separated by spaces.  This procedure behaves  differently  than  Tcl_Merge,  in  that  the
       arguments  are  simply  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