diff options
Diffstat (limited to 'tcl8.6/doc/Concat.3')
-rw-r--r-- | tcl8.6/doc/Concat.3 | 51 |
1 files changed, 0 insertions, 51 deletions
diff --git a/tcl8.6/doc/Concat.3 b/tcl8.6/doc/Concat.3 deleted file mode 100644 index 58a0fb6..0000000 --- a/tcl8.6/doc/Concat.3 +++ /dev/null @@ -1,51 +0,0 @@ -'\" -'\" Copyright (c) 1989-1993 The Regents of the University of California. -'\" Copyright (c) 1994-1996 Sun Microsystems, Inc. -'\" -'\" See the file "license.terms" for information on usage and redistribution -'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. -'\" -.TH Tcl_Concat 3 7.5 Tcl "Tcl Library Procedures" -.so man.macros -.BS -.SH NAME -Tcl_Concat \- concatenate a collection of strings -.SH SYNOPSIS -.nf -\fB#include <tcl.h>\fR -.sp -const char * -\fBTcl_Concat\fR(\fIargc, argv\fR) -.SH ARGUMENTS -.AS "const char *const" argv[] -.AP int argc in -Number of strings. -.AP "const char *const" argv[] in -Array of strings to concatenate. Must have \fIargc\fR entries. -.BE - -.SH DESCRIPTION -.PP -\fBTcl_Concat\fR 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 -\fBTcl_Merge\fR, 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. -.PP -\fBTcl_Concat\fR eliminates leading and trailing white space as it -copies strings from \fBargv\fR to the result. If an element of -\fBargv\fR consists of nothing but white space, then that string -is ignored entirely. This white-space removal was added to make -the output of the \fBconcat\fR command cleaner-looking. -.PP -The result string is dynamically allocated -using \fBTcl_Alloc\fR; the caller must eventually release the space -by calling \fBTcl_Free\fR. -.SH "SEE ALSO" -Tcl_ConcatObj -.SH KEYWORDS -concatenate, strings |