| native-transcoder(3scm) | Scheme Programmer's Manual | native-transcoder(3scm) |
NAME
native-transcoder - transcoder for the native transcoding
LIBRARY
(import (rnrs)) ;R6RS (import (rnrs io ports)) ;R6RS
SYNOPSIS
(native-transcoder)
DESCRIPTION
Returns an implementation-dependent transcoder that represents a possibly locale-dependent "native" transcoding.
This is commonly a UTF-8 transcoder with eol-style none (on Unix-like systems) and crlf on DOS and Windows systems, but can be anything that goes well with the native operating system.
IMPLEMENTATION NOTES
See the notes in native-eol-style(3scm).
RETURN VALUES
Returns a single value; a transcoder.
EXAMPLES
(transcoder-error-handling-mode (native-transcoder))
=> replace
APPLICATION USAGE
The returned transcoder is used as an argument to various I/O procedures, such as bytevector->string(3scm), string->bytevector(3scm), open-bytevector-output-port(3scm), open-file-input-port(3scm), and open-file-output-port(3scm).
COMPATIBILITY
Transcoders are unique to the R6RS I/O system.
ERRORS
This procedure can raise exceptions with the following condition types:
- &assertion (R6RS)
- The wrong number of arguments was passed.
SEE ALSO
native-eol-style(3scm)
STANDARDS
R6RS
HISTORY
This procedure was introduced in R6RS as part of the reworked I/O system.
AUTHORS
This page is part of the scheme-manpages project. It includes materials from the RnRS documents. More information can be found at https://weinholt.se/scheme/manpages/.
| 2022-05-14 |