bytevector=?(3scm)

📦 version 0-unstable-2024-02, in nixpkgs unstable

👑 bytevector=?(3scm) — the bytevector equality vibe check 👑

okay so this is from the Scheme Programmer's Manual, and we are about to compare two bytevectors like it's our job. no cap. 💅

💖 NAME 💖

bytevector=? — compare two bytevectors. that's the whole assignment, bestie. 🫶

📚 LIBRARY 📚

you pull it in from either of these, depending on your R6RS situation:

(import (rnrs))                     ;R6RS
(import (rnrs bytevectors))         ;R6RS

✨ SYNOPSIS ✨

(bytevector=? bytevector1 bytevector2)

🌸 DESCRIPTION 🌸

so bytevector=? hands back #t when bytevector1 and bytevector2 are equal. and equal means they have the same length and equal bytes at all valid indices. if that's not the case, you get #f. periodt. 💖

🎀 RETURN VALUES 🎀

returns a single boolean object. that's it. one boolean object, living its truth. ✨

🦋 EXAMPLES 🦋

look at these little icons slaying:

(bytevector=? #vu8(1 2 3) #vu8(1 2 3))  =>  #t
(bytevector=? #vu8(1 2 3) #vu8(0 1 2))  =>  #f

🚨 APPLICATION USAGE 🚨

bestie, this is serious: programs that work with sensitive data such as passwords and message digests must never use this procedure with attacker-controlled data.

why? it may leak information through the time it takes to execute, leading to the movie trope where a password is cracked one letter at a time. 💀 no cap, do not do it.

💅 COMPATIBILITY 💅

this procedure is absent from R7RS. use equal?(3scm) instead. lowkey important. 🫶

😭 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.

🔥 SEE ALSO 🔥

equal?(3scm)

👑 STANDARDS 👑

R6RS. periodt. 💜

🌈 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/. 🧚

sign-off 🌸: this page is from the Scheme Programmer's Manual, dated 2021-02-28, and it's the bytevector=?(3scm) page. mwah. 💖

📦 where this page comes from