native-transcoder(3scm)

💅 native-transcoder(3scm) — the Scheme Programmer's Manual, but make it cute

okay so bestie, we're in the native-transcoder(3scm) page of the Scheme Programmer's Manual and honestly? this one's short and sweet. let's get into it 🫶

---

✨ NAME ✨

native-transcoder — the transcoder for the native transcoding. that's it, that's the whole name, no notes 💅

📚 LIBRARY 📚

two ways to get at it, pick your fighter:

(import (rnrs))                     ;R6RS
(import (rnrs io ports))            ;R6RS

🎀 SYNOPSIS 🎀

(native-transcoder)

zero arguments, zero drama, one call. iconic behaviour honestly ⭐

💖 DESCRIPTION 💖

So what does it actually do? It returns an implementation-dependent transcoder that represents a possibly locale-dependent "native" transcoding. like, it's giving "whatever your OS thinks is normal" energy and we respect it 🌈

The tea ☕: this is commonly a UTF-8 transcoder with eol-style none on Unix-like systems, and crlf on DOS and Windows systems — but ngl it can be anything that goes well with the native operating system. so don't come for it if it's not exactly that, the implementation gets to choose, fr fr 💀

🧚 IMPLEMENTATION NOTES 🧚

See the notes in native-eol-style(3scm). that's where the eol lore lives, go read it bestie 👑

🦋 RETURN VALUES 🦋

Returns a single value — a transcoder. just the one, no bonus surprises, no cap ✨

🌸 EXAMPLES 🌸

here's the little demo and it ate, lowkey:

(transcoder-error-handling-mode (native-transcoder))
        => replace

see? replace. default error handling mode said "we move" 💅

🍓 APPLICATION USAGE 🍓

You don't just stare at the returned transcoder (as tempting as that is) — you pass it as an argument to various I/O procedures, like:

• bytevector->string(3scm)
• string->bytevector(3scm)
• open-bytevector-output-port(3scm)
• open-file-input-port(3scm)
• open-file-output-port(3scm)

that's its whole job and it's doing it beautifully 🫶

💀 COMPATIBILITY 💀

Transcoders are unique to the R6RS I/O system. so if you're on some other Scheme situation, this is not gonna vibe-check for you, sorry bestie 😭

🔥 ERRORS 🔥

This procedure can raise exceptions with the following condition types:

• &assertion (R6RS) — the wrong number of arguments was passed. you gave it an argument, it wanted none (or vice versa) and now we're all looking at each other 🙈

👑 SEE ALSO 👑

• native-eol-style(3scm) — the sibling page, the eol icon itself, go show it some love 🎀

⭐ STANDARDS ⭐

R6RS. that's the standard, periodt 💜

🌈 HISTORY 🌈

This procedure was introduced in R6RS as part of the reworked I/O system. so it's a glow-up baby, born in the great I/O rework ✨

🧚 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/. shoutout to the maintainers, they're the real main characters tbh 🫶

---

and that's the whole page bestie, no skip, no summary, every single detail intact, we ate and left no crumbs 🍓

source / version: native-transcoder(3scm)  ·  date: 2022-05-14 — mwah, signed off with love, go transcode something iconic 💅💖