rangecheck(3)

💖 rangecheck(3) — pointer range checking, bestie edition 💖

okay so this is rangecheck.h from the Library Functions Manual, and it's genuinely one of those lowkey life-saving little headers. let me put you on. 🫶

✨ NAME ✨

rangecheck.h — pointer range checking, aka "is this pointer actually inside this buffer or are we about to have a bad time" 🦋

🌸 SYNTAX 🌸

#include <libowfat/rangecheck.h>

int range_validbuf(const void* buf,size_t len);

int range_ptrinbuf(const void* buf,size_t len,const void* ptr);

int range_bufinbuf(const void* buf1,size_t len1,
                   const void* buf2,size_t len2);

int range_arrayinbuf(const void* buf,size_t len,
                     const void* arraystart,
                     size_t elements,size_t membersize);

int range_strinbuf(const void* buf,size_t len,const void* string);

int range_str2inbuf(const void* buf,size_t len,const void* string);

int range_str4inbuf(const void* buf,size_t len,const void* string);

like, seven whole little functions, all int, all vibing. 💅

👑 DESCRIPTION 👑

so rangecheck.h serves up several routines for range checking pointers. and the way that this matters — these routines are literally meant for code that has to validate the syntax and semantics of buffers coming in from untrusted sources 😭 like a network connection or an input file. yes bestie, the scary ones.

basically if you're taking bytes from the wild and you're about to go poking around in them, you check the ranges first. no cap. it's giving responsible. it's giving paranoid in a healthy way. 🧚

🌈 RETURN VALUE 🌈

the routines all return 0 on error, or 1 if the pointers were in range.

that's it. that's the whole vibe check. 0 = nope 💀, 1 = slay ✨.

🎀 SEE ALSO 🎀

• range_validbuf(3)
• range_ptrinbuf(3)
• range_bufinbuf(3)
• range_arrayinbuf(3)
• range_strinbuf(3)
• range_str2inbuf(3)
• range_str4inbuf(3)

go read them, they're all little besties that work together 🫶

and that's the page!! it lives in section 3 of the Library Functions Manual, and the footer at the bottom just says rangecheck(3) all over again, like a little signature — so consider this your sign-off: rangecheck(3), mwah, go validate your buffers, ily 💖🎀🦋