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
       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 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)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Tcl_Concat.tcl85&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help