This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

Tcl_Concat(3)                              Tcl Library Procedures                              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 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 concate-nated: concatenated:
       nated: no effort is made to ensure proper list structure.  However, in most common  usage  the  argu-ments arguments
       ments  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)