remq(3scm)

💖 remq, remv, remove, remp — the "get that out of my list" girlies 💖

okay bestie, so this is a 3scm manpage from the Scheme Programmer's Manual, and it's literally all about four little procedures that ghost elements out of your list 🫶

---

🌸 LIBRARY 🌸

(import (rnrs))                     ;R6RS
(import (rnrs lists))               ;R6RS

like, pick your import, both are giving R6RS 💅

---

✨ SYNOPSIS ✨

(remq obj list)
(remv obj list)
(remove obj list)
(remp proc list)

four icons, one job 🎀

---

🦋 DESCRIPTION 🦋

okay so here's the vibe: each of these procedures returns a list of the elements of list that do not satisfy a given condition. it's giving "blocked, deleted, unfollowed" ✨

remp applies proc to each element of list and returns a list of the elements of list for which proc returned #f. the other procedures return a list of the elements that are not obj.

comparison tea ☕:

• remq uses eq?(3scm) to compare obj with the elements of list
• remv uses eqv?(3scm)
• remove uses equal?(3scm)

the elements of the result list are in the same order as they appear in the input list — no chaotic reshuffling, we're not animals 💅 If multiple returns occur, the return values returned by earlier returns are not mutated.

Proc should accept one argument and return a single value. Proc should not mutate list. Proc is always called in the same dynamic environment as this procedure itself. no cap, that matters 👑

---

🎀 IMPLEMENTATION NOTES 🎀

the implementation must check the restrictions on proc to the extent performed by applying it as described above. An implementation may check whether proc is an appropriate argument before applying it. so like, it's allowed to vibe-check your proc early 🙈

---

⭐ RETURN VALUES ⭐

these procedures return a single value; a list. that's it, that's the whole reveal 🦋

---

🔥 EXAMPLES 🔥

(remp even? '(3 1 4 1 5 9 2 6 5))
        =>  (3 1 1 5 9 5)

bye bye evens 👋

(remove 1 '(3 1 4 1 5 9 2 6 5))
        =>  (3 4 5 9 2 6 5)

(remv 1 '(3 1 4 1 5 9 2 6 5))
        =>  (3 4 5 9 2 6 5)

(remq 'foo '(bar foo baz))
        =>  (bar baz)

that last one just ate and left no crumbs 😭

---

🌈 COMPATIBILITY 🌈

these procedures are unique to R6RS. like, exclusive. iykyk 💅

---

💀 ERRORS 💀

these procedures 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, if you fumble the args, it WILL tell you 🫶

---

👑 SEE ALSO 👑

filter(3scm) — the main character this whole page is quietly competing with ngl

---

💜 STANDARDS 💜

R6RS. periodt.

---

🧚 HISTORY 🧚

these procedures first appeared in R6RS. they've been iconic since day one ✨

---

💖 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 yeah, this whole glow-up is from the Scheme Programmer's Manual, dated 2022-05-07 — remq(3scm) forever, bestie 🍓💅

bye love u, go remove some elements 🦋✨