newline(3scm)

💖 newline — write a newline to a port 💖

okay bestie, so this is newline from the Scheme Programmer's Manual, and it's lowkey one of the most iconic little procedures ever — it just... ends a line. that's it. that's the whole vibe. ✨

---

🌸 LIBRARY 🌸

import it from whichever flavour of Scheme you're living in, no judgement:

(import (rnrs))                     ;R6RS
(import (rnrs io simple))           ;R6RS
(import (scheme r5rs))              ;R7RS
(import (scheme base))              ;R7RS

---

🎀 SYNOPSIS 🎀

(newline)
(newline textual-output-port)

---

💅 DESCRIPTION 💅

So it writes an end of line to textual-output-port, which defaults to whatever current-output-port(3scm) hands back. yes bestie, default port, it just knows. 🫶

R6RS — this is literally equivalent to using write-char(3scm) to write #\linefeed to textual-output-port.

the port's transcoder eol-style decides which characters actually get written to the port. so like, the flavour of newline is not your call here, it's the transcoder's call. periodt.

also!! ports with their buffer-mode set to line will be flushed as a side-effect of calling this procedure. so you get a little flush for free, no cap. 🦋

R7RS — exactly how a newline is produced, and which characters are used, differs from one operating system to another. so it's giving "trust the implementation" energy. 🙈

---

⭐ RETURN VALUES ⭐

• R6RS — returns unspecified values.
• R7RS — returns an unspecified value.

(notice the singular vs plural, we keep the details exact around here 💜)

---

🌈 EXAMPLES 🌈

(display "Hello, world!")
(newline)

look at that. beautiful. iconic. hello world but on its own line. 🔥

---

🧚 APPLICATION USAGE 🧚

in R6RS programs this procedure may be used instead of \n in a string or instead of writing #\linefeed. very "we have options, pick your fave" of it.

in R7RS programs this procedure writes the characters that would have been selected for a newline by using a transcoder with native-eol-style(3scm) in R6RS. iykyk. 💫

---

👑 COMPATIBILITY 👑

this procedure has had the same basic functionality since R2RS. she's a legacy icon, she's been doing this since forever. 🎀

in R6RS implementations it's possible to control the eol-style. fancy.

---

💀 ERRORS 💀

this procedure can raise exceptions with the following condition types:

• &assertion (R6RS) — the wrong number of arguments was passed or an argument was outside its domain. so like, don't do that bestie 😭
• R7RS — the assertions described above are errors. implementations may signal an error, extend the procedure's domain of definition to include such arguments, or fail catastrophically. yes, fail catastrophically, that's the actual wording, we're not being dramatic for once 💀

---

🍓 SEE ALSO 🍓

• get-line(3scm)
• put-char(3scm)

---

🦋 STANDARDS 🦋

R4RS, IEEE Scheme, R5RS, R6RS, R7RS — she's certified in literally all of them. ate. 💅

---

🌸 HISTORY 🌸

first appeared in R2RS. Scheme running on top of MacLisp has access to the same functionality through the terpri (TERminate PRInt line) function, which was also in LISP 1.5. deep lore, we love to see it. 🧚

---

💜 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/.

---

and that's the whole page bestie, mwah 🫶 — this little masterpiece is from 2022-05-07, filed under newline(3scm), bestie-certified and ready to end your lines 💖✨