diff options
author | Ian Roxborough <irox@redhat.com> | 2001-09-09 22:40:53 +0000 |
---|---|---|
committer | Ian Roxborough <irox@redhat.com> | 2001-09-09 22:40:53 +0000 |
commit | a850c17c374d03259483e799b09326d255e17487 (patch) | |
tree | f1d024951a993f0453aa49d4ba808d6c38fa4321 /tcl/doc/DString.3 | |
parent | 57e8350a3895a1579b77cc134d6d7d49b056678e (diff) | |
download | gdb-a850c17c374d03259483e799b09326d255e17487.tar.gz |
Tcl 8.3 upgradeTCL_8_3
Diffstat (limited to 'tcl/doc/DString.3')
-rw-r--r-- | tcl/doc/DString.3 | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/tcl/doc/DString.3 b/tcl/doc/DString.3 index 00b76bde315..ae73fe83ef7 100644 --- a/tcl/doc/DString.3 +++ b/tcl/doc/DString.3 @@ -36,6 +36,8 @@ char * .sp \fBTcl_DStringSetLength\fR(\fIdsPtr, newLength\fR) .sp +\fBTcl_DStringTrunc\fR(\fIdsPtr, newLength\fR) +.sp \fBTcl_DStringFree\fR(\fIdsPtr\fR) .sp \fBTcl_DStringResult\fR(\fIinterp, dsPtr\fR) @@ -124,13 +126,17 @@ caller to fill in the new space. even if the string is truncated to zero length, so \fBTcl_DStringFree\fR will still need to be called. .PP +\fBTcl_DStringTrunc\fR changes the length of a dynamic string. +This procedure is now deprecated. \fBTcl_DStringSetLength\fR should +be used instead. +.PP \fBTcl_DStringFree\fR should be called when you're finished using the string. It frees up any memory that was allocated for the string and reinitializes the string's value to an empty string. .PP \fBTcl_DStringResult\fR sets the result of \fIinterp\fR to the value of the dynamic string given by \fIdsPtr\fR. It does this by moving -a pointer from \fIdsPtr\fR to \fIinterp->result\fR. +a pointer from \fIdsPtr\fR to the interpreter's result. This saves the cost of allocating new memory and copying the string. \fBTcl_DStringResult\fR also reinitializes the dynamic string to an empty string. |