diff options
author | Mark H Weaver <mhw@netris.org> | 2013-08-07 00:46:34 -0400 |
---|---|---|
committer | Mark H Weaver <mhw@netris.org> | 2013-08-07 01:22:22 -0400 |
commit | 6dce942c46494460369b8a93d3c657e1f6e57fed (patch) | |
tree | f8242c3dea0e724e78018a32c558f9d11d763bc5 /doc/ref/api-io.texi | |
parent | d8d7c7bf5706ce7873257eb88f0a5cc01b541858 (diff) | |
download | guile-6dce942c46494460369b8a93d3c657e1f6e57fed.tar.gz |
String ports use UTF-8; ignore %default-port-encoding.
* libguile/strports.c (scm_mkstrport): Use UTF-8; ignore
%default-port-encoding. Rename 'str_len' and 'c_pos' to
'num_bytes' and 'c_byte_pos'. Interpret 'pos' argument
as a character index instead of a byte index.
* module/ice-9/boot-9.scm (%cond-expand-features): Add srfi-6 to the
list of core features.
* module/srfi/srfi-6.scm (open-input-string, open-output-string): Simply
re-export these, since the core versions are now compliant.
* doc/ref/api-io.texi (String Ports): Remove text that describes
non-compliant behavior of string ports with regard to encoding.
* doc/ref/srfi-modules.texi (SRFI-0): Add srfi-6 to the list of
core features.
(SRFI-6): Remove text that mentions non-compliant behavior of
core string ports.
* module/ice-9/format.scm (format):
* module/ice-9/pretty-print.scm (truncated-print):
* module/rnrs/io/ports.scm (open-string-input-port,
open-string-output-port):
* test-suite/test-suite/lib.scm (format-test-name):
* test-suite/tests/chars.test ("combining accent is pretty-printed",
"combining X is pretty-printed"):
* test-suite/tests/ecmascript.test (eread, eread/1):
* test-suite/tests/rdelim.test:
* test-suite/tests/reader.test (read-string):
* test-suite/tests/regexp.test:
* test-suite/tests/srfi-105.test (read-string): Don't set
%default-port-encoding before creating string ports.
* benchmark-suite/benchmarks/ports.bm (%latin1-port): Use
'set-port-encoding!' to set the string port encoding.
(%utf8/ascii-port, %utf8/wide-port, "rdelim"): Don't set
%default-port-encoding before creating string ports.
* test-suite/tests/r6rs-ports.test ("lookahead-u8 non-ASCII"): Don't set
%default-port-encoding before creating string ports.
("put-bytevector with UTF-16 string port", "put-bytevector with
wrong-encoding string port"): Use 'set-port-encoding!' to set the
string port encoding.
* test-suite/tests/print.test (tprint): Use 'set-port-encoding!' to set
the string port encoding.
("truncated-print"): Use 'pass-if-equal'.
* test-suite/tests/ports.test ("encoding failure leads to exception",
"%default-port-encoding is honored", "peek-char [latin-1]", "peek-char
[utf-8]", "peek-char [utf-16]"): Remove tests.
("%default-port-encoding is ignored", "peek-char"): Add tests.
("suitable encoding [latin-1]", "suitable encoding [latin-3]",
"wrong encoding, error", "wrong encoding, substitute",
"wrong encoding, escape"): Use 'set-port-encoding!' to set the
string port encoding.
("%default-port-encoding, wrong encoding"): Rewrite to use
a file port instead of a string port.
Diffstat (limited to 'doc/ref/api-io.texi')
-rw-r--r-- | doc/ref/api-io.texi | 24 |
1 files changed, 0 insertions, 24 deletions
diff --git a/doc/ref/api-io.texi b/doc/ref/api-io.texi index 4c42de8d0..8e3d40a69 100644 --- a/doc/ref/api-io.texi +++ b/doc/ref/api-io.texi @@ -1066,28 +1066,6 @@ away from its default. Calls the one-argument procedure @var{proc} with a newly created output port. When the function returns, the string composed of the characters written into the port is returned. @var{proc} should not close the port. - -Note that which characters can be written to a string port depend on the port's -encoding. The default encoding of string ports is specified by the -@code{%default-port-encoding} fluid (@pxref{Ports, -@code{%default-port-encoding}}). For instance, it is an error to write Greek -letter alpha to an ISO-8859-1-encoded string port since this character cannot be -represented with ISO-8859-1: - -@example -(define alpha (integer->char #x03b1)) ; GREEK SMALL LETTER ALPHA - -(with-fluids ((%default-port-encoding "ISO-8859-1")) - (call-with-output-string - (lambda (p) - (display alpha p)))) - -@result{} -Throw to key `encoding-error' -@end example - -Changing the string port's encoding to a Unicode-capable encoding such as UTF-8 -solves the problem. @end deffn @deffn {Scheme Procedure} call-with-input-string string proc @@ -1101,8 +1079,6 @@ read. The value yielded by the @var{proc} is returned. Calls the zero-argument procedure @var{thunk} with the current output port set temporarily to a new string port. It returns a string composed of the characters written to the current output. - -See @code{call-with-output-string} above for character encoding considerations. @end deffn @deffn {Scheme Procedure} with-input-from-string string thunk |