Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
       Tcl_Size	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 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tcl_Concat.tcl90&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help