Manual page for native-transcoder(3scm)

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.

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://github.com/schemedoc/manpages/.

Markup created by unroff 1.0sc, March 04, 2023.