Unix/Linux Go Back    


CentOS 7.0 - man page for tcl_concat (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 04:41 PM.