summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2003-07-11 21:18:55 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2003-07-11 21:18:55 (GMT)
commitc188371e379c3b139e3ddc924121ad3c64860c7e (patch)
tree21bdbf619a8fe3994496ef65beec8850f973bf8b /doc
parent50e63af8e12e08f7d7e8f6808a1fe7a656d934f9 (diff)
downloadtcl-c188371e379c3b139e3ddc924121ad3c64860c7e.zip
tcl-c188371e379c3b139e3ddc924121ad3c64860c7e.tar.gz
tcl-c188371e379c3b139e3ddc924121ad3c64860c7e.tar.bz2
Documented and tested for the current behaviour of [binary format a] and
[binary scan ? a]. This is what they've been doing all along. [Bug 735364]
Diffstat (limited to 'doc')
-rw-r--r--doc/binary.n14
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/binary.n b/doc/binary.n
index 997963a..80a6460 100644
--- a/doc/binary.n
+++ b/doc/binary.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: binary.n,v 1.11.2.2 2003/04/10 08:28:15 dkf Exp $
+'\" RCS: @(#) $Id: binary.n,v 1.11.2.3 2003/07/11 21:18:55 dkf Exp $
'\"
.so man.macros
.TH binary n 8.0 Tcl "Tcl Built-In Commands"
@@ -65,6 +65,12 @@ position 0 at the beginning of the data. The type may be any one of
the following characters:
.IP \fBa\fR 5
Stores a character string of length \fIcount\fR in the output string.
+Every character is taken as modulo 256 (i.e. the low byte of every
+character is used, and the high byte discarded) so when storing
+character strings not wholly expressible using the characters
+\bu0000-\bu00ff, the \fBencoding convertto\fR command should be used
+first if this truncation is not desired (i.e. if the characters are
+not part of the ISO 8859-1 character set.)
If \fIarg\fR has fewer than \fIcount\fR bytes, then additional zero
bytes are used to pad out the field. If \fIarg\fR is longer than the
specified length, the extra characters will be ignored. If
@@ -383,7 +389,11 @@ the following characters:
The data is a character string of length \fIcount\fR. If \fIcount\fR
is \fB*\fR, then all of the remaining bytes in \fIstring\fR will be
scanned into the variable. If \fIcount\fR is omitted, then one
-character will be scanned. For example,
+character will be scanned.
+All characters scanned will be interpreted as being in the range
+\bu0000-\bu00ff so the \fBencoding convertfrom\fR command might be
+needed if the string is not an ISO 8859\-1 string.
+For example,
.RS
.CS
\fBbinary scan abcde\\000fghi a6a10 var1 var2\fR