Tcl_Concat(3)         Tcl Library Procedures        Tcl_Concat(3)



_________________________________________________________________

NAME
       Tcl_Concat - concatenate a collection of strings

SYNOPSIS
       #include 

       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 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                                       |



Tcl                            7.5                  Tcl_Concat(3)