Tcl_Concat man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



Tcl_Concat(3)	      Tcl Library Procedures	    Tcl_Concat(3)

_________________________________________________________________

NAME
       Tcl_Concat - concatenate a collection of strings

SYNOPSIS
       #include <tcl.h>

       char *
       Tcl_Concat(argc, argv)

ARGUMENTS
       int	    argc	       (in)	 Number	       of
						 strings.

       char	    *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.

KEYWORDS
       concatenate, strings

Tcl			       7.5				1

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net