summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordgp <dgp@users.sourceforge.net>2014-08-25 21:37:58 (GMT)
committerdgp <dgp@users.sourceforge.net>2014-08-25 21:37:58 (GMT)
commit1ca69943d5e3146511079b413ad981d77c387bd0 (patch)
treea8455def2184b74d19c31c9a890465558babc2b2 /doc
parentc154199c655b9c1abf0bf23d44624ab1277a7bb8 (diff)
parent22bb3f2bf92e4ea63f1c85a09e106235943b27eb (diff)
downloadtcl-1ca69943d5e3146511079b413ad981d77c387bd0.zip
tcl-1ca69943d5e3146511079b413ad981d77c387bd0.tar.gz
tcl-1ca69943d5e3146511079b413ad981d77c387bd0.tar.bz2
TIP 429 implementation. New command [string cat].
Diffstat (limited to 'doc')
-rw-r--r--doc/string.n15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/string.n b/doc/string.n
index 72a69ff..33780ff 100644
--- a/doc/string.n
+++ b/doc/string.n
@@ -19,6 +19,21 @@ string \- Manipulate strings
Performs one of several string operations, depending on \fIoption\fR.
The legal \fIoption\fRs (which may be abbreviated) are:
.TP
+\fBstring cat\fR ?\fIstring1\fR? ?\fIstring2...\fR?
+.VS 8.6.2
+Concatenate the given \fIstring\fRs just like placing them directly
+next to each other and return the resulting compound string. If no
+\fIstring\fRs are present, the result is an empty string.
+.RS
+.PP
+This primitive is occasionally handier than juxtaposition of strings
+when mixed quoting is wanted, or when the aim is to return the result
+of a concatenation without resorting to \fBreturn\fR \fB\-level 0\fR,
+and is more efficient than building a list of arguments and using
+\fBjoin\fR with an empty join string.
+.RE
+.VE
+.TP
\fBstring compare\fR ?\fB\-nocase\fR? ?\fB\-length\fI length\fR? \fIstring1 string2\fR
.
Perform a character-by-character comparison of strings \fIstring1\fR