|
|
1.1 root 1: '\" Copyright 1989 Regents of the University of California
2: '\" Permission to use, copy, modify, and distribute this
3: '\" documentation for any purpose and without fee is hereby
4: '\" granted, provided that this notice appears in all copies.
5: '\" The University of California makes no representations about
6: '\" the suitability of this material for any purpose. It is
7: '\" provided "as is" without express or implied warranty.
8: '\"
9: '\" $Header: /sprite/src/lib/tcl/RCS/Tcl_Merge.man,v 1.2 89/03/24 14:16:16 ouster Exp $ SPRITE (Berkeley)
10: '\"
11: .so \*(]ltmac.sprite
12: .HS Tcl_Concat tcl
13: .BS
14: .SH NAME
15: Tcl_Concat \- concatenate a collection of strings
16: .SH SYNOPSIS
17: .nf
18: \fB#include <tcl.h>\fR
19: .sp
20: char *
21: \fBTcl_Concat\fR(\fIargc, argv\fR)
22: .SH ARGUMENTS
23: .AP int argc in
24: Number of strings.
25: .AP char *argv[] in
26: Array of strings to concatenate. Must have \fIargc\fR entries.
27: .BE
28:
29: .SH DESCRIPTION
30: .PP
31: \fBTcl_Concat\fR is a utility procedure used by several of the
32: Tcl commands. Given a collection of strings, it concatenates
33: them together into a single string, with the original strings
34: separated by spaces. This procedure behaves differently than
35: \fBTcl_Merge\fR, in that the arguments are simply concatenated:
36: no effort is made to ensure proper list structure.
37: The result string is dynamically allocated
38: using \fBmalloc()\fR; the caller must eventually release the space
39: by calling \fBfree()\fR.
40:
41: .SH KEYWORDS
42: concatenate, strings
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.