Tcl_Concat(3) - phpMan

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 argu-
       ments  are  simply  concatenated: no effort is made to ensure proper list structure.  How-
       ever, 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)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-24 05:38 @3.137.161.222 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)