vector-for-each(3scm)

💅 vector-for-each(3scm) 💅

okay bestie, welcome to the Scheme Programmer's Manual — this is the page for vector-for-each, and it's giving “tiny loop, big side-effect energy” ✨

🌸 NAME 🌸

vector-for-each — loop over the elements of a vector 💖

📚 LIBRARY 📚

fr fr, import it from one of these:

(import (rnrs))                     ;R6RS
(import (rnrs base))                ;R6RS
(import (scheme base))              ;R7RS

✨ SYNOPSIS ✨

(vector-for-each proc vector1 vector2 ...)

🦋 DESCRIPTION 🦋

So the vibe is: it applies proc element-wise to the elements of the vectors, for its side effects, in order from the first elements to the last. 💫

R6RS — proc is always called in the same dynamic environment as vector-for-each itself. Also, the implementation must check the restrictions on proc to the extent performed by applying it as described. An implementation may check whether proc is an appropriate argument before applying it.

R7RS — if more than one vector is given and not all vectors have the same length, vector-for-each terminates when the shortest vector runs out. ✂️

🎀 RETURN VALUES 🎀

R6RS — returns unspecified values.

R7RS — returns an unspecified value.

🌈 EXAMPLES 🌈

(vector-for-each
  display
  '#("Hello, " "world" ".0))
; prints: Hello, world.

💭 RATIONALE 💭

R7RS says that this procedure and a few others were added in order to round out the sequence operations. iconic behavior, honestly 👑

🫶 COMPATIBILITY 🫶

The R7RS variant of this procedure terminates early if the vectors are not the same length, but the R6RS variant requires that all the vectors are the same length. Additionally R7RS makes it an error to mutate any of the vectors.

💀 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. In particular, the vectors should all have the same length and proc should accept as many arguments as there are vectors.
• R7RS — the assertions described above (except for the length requirement) are errors. Implementations may signal an error, extend the procedure's domain of definition to include such arguments, or fail catastrophically. It is an error for proc to mutate any of the vectors.

bestie, “fail catastrophically” is right there in the manual — do not test that vibe on purpose 😭

👀 SEE ALSO 👀

• for-each(3scm)
• vector-map(3scm)

⭐ STANDARDS ⭐

R6RS, R7RS

🕰️ HISTORY 🕰️

This procedure first appeared in R6RS. It was later also added to R7RS.

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

---

💖 okay that's the whole page, bestie — vector-for-each(3scm) from the Scheme Programmer's Manual, dated 2023-01-23. stay slay, happy looping! 🫶✨