summaryrefslogtreecommitdiffstats
path: root/doc/Utf.3
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2019-03-18 22:34:14 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2019-03-18 22:34:14 (GMT)
commit59ad43ee2cc3bf96c957151d431acd9a423e604d (patch)
tree2fccb9a139931d42427bd38662ef8b98e6b4787d /doc/Utf.3
parent1dd829fb01e13e3c74113061a59bea80ad2b7860 (diff)
parent04ea3b8bff2991e54cc2469b372927735c9d7a83 (diff)
downloadtcl-59ad43ee2cc3bf96c957151d431acd9a423e604d.zip
tcl-59ad43ee2cc3bf96c957151d431acd9a423e604d.tar.gz
tcl-59ad43ee2cc3bf96c957151d431acd9a423e604d.tar.bz2
Merge 8.7
Diffstat (limited to 'doc/Utf.3')
-rw-r--r--doc/Utf.37
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/Utf.3 b/doc/Utf.3
index 3ae5c0e..80c86aa 100644
--- a/doc/Utf.3
+++ b/doc/Utf.3
@@ -130,9 +130,10 @@ represent one Unicode character in the UTF-8 representation.
\fBTcl_UniCharToUtf\fR stores the character \fIch\fR as a UTF-8 string
in starting at \fIbuf\fR. The return value is the number of bytes stored
in \fIbuf\fR. If ch is a high surrogate (range U+D800 - U+DBFF), then
-the return value will be 0 and nothing will be stored. If you still
-want to produce UTF-8 output for it (even though knowing it's an illegal
-code-point on its own), just call \fBTcl_UniCharToUtf\fR again using ch = -1.
+the return value will be 1 and a single byte in the range 0xF0 - 0xF4
+will be stored. If you still want to produce UTF-8 output for it (even
+though knowing it's an illegal code-point on its own), just call
+\fBTcl_UniCharToUtf\fR again specifying ch = -1.
.PP
\fBTcl_UtfToUniChar\fR reads one UTF-8 character starting at \fIsrc\fR
and stores it as a Tcl_UniChar in \fI*chPtr\fR. The return value is the