summaryrefslogtreecommitdiffstats
path: root/doc/StringObj.3
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2022-05-19 15:04:35 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2022-05-19 15:04:35 (GMT)
commit38b14d2a41d19eb2cec5ebb6cb838e887643c0a9 (patch)
tree6dc682e3a1e15da17d07a67284e0b646867b52df /doc/StringObj.3
parentfdedfe57992474d342bf1ecb84bc04ae0fd9aeb2 (diff)
parent53a20bbf1cf609252a8ec050ed68a139687e7ad0 (diff)
downloadtcl-38b14d2a41d19eb2cec5ebb6cb838e887643c0a9.zip
tcl-38b14d2a41d19eb2cec5ebb6cb838e887643c0a9.tar.gz
tcl-38b14d2a41d19eb2cec5ebb6cb838e887643c0a9.tar.bz2
Merge 9.0
Diffstat (limited to 'doc/StringObj.3')
-rw-r--r--doc/StringObj.37
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/StringObj.3 b/doc/StringObj.3
index 2793f7d..74d6d02 100644
--- a/doc/StringObj.3
+++ b/doc/StringObj.3
@@ -188,7 +188,9 @@ Even in the limited situations where writing to this pointer is
acceptable, one should take care to respect the copy-on-write
semantics required by \fBTcl_Obj\fR's, with appropriate calls
to \fBTcl_IsShared\fR and \fBTcl_DuplicateObj\fR prior to any
-in-place modification of the string representation.
+in-place modification of the string representation. If \fIlengthPtr\fR
+points to an \fBint\fR variable, and the string has more than 2^31 bytes,
+a panic will result.
The procedure \fBTcl_GetString\fR is used in the common case
where the caller does not need the length of the string
representation.
@@ -200,7 +202,8 @@ value as a Unicode string. This is given by the returned pointer and
byte pointer is owned by the value manager and should not be modified by
the caller. The procedure \fBTcl_GetUnicode\fR is used in the common case
where the caller does not need the length of the unicode string
-representation.
+representation. If \fIlengthPtr\fR points to an \fBint\fR variable,
+and the string has more than 2^31 unicode characters, a panic will result.
.PP
\fBTcl_GetUniChar\fR returns the \fIindex\fR'th character in the
value's Unicode representation. If the index is out of range or