range_arrayinbuf(3)

💖 range_arrayinbuf(3) 💖

ok so bestie, welcome to the Library Functions Manual ✨ this is range_arrayinbuf(3) and she is literally the friend who checks your math before you do something unhinged 🫶

🌸 NAME 🌸

range_arrayinbuf — range check for array in buffer

✨ SYNTAX ✨

#include <libowfat/rangecheck.h>

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

🦋 DESCRIPTION 🦋

ok so here's the vibe: range_arrayinbuf checks that the array starting at arraystart, made up of elements members that are membersize each, starts and ends within the buffer buf[0..len-1]. that's it. that's the whole job. and she does it flawlessly 💅

like, if you're about to go poking at memory and you want a bouncer at the door first? this is your bouncer. no cap 🔥

not me about to warn you though: if the array is 0-terminated and you don't know the length beforehand, use range_strinbuf, range_str2inbuf or range_str4inbuf instead 🙈 different tool, different job, don't mix them up bestie.

👑 RETURN VALUE 👑

so what does she give back? let's go:

• If the buffer is implausible (buf is NULL or buf+len has an integer overflow), return 0. 🚫
• If the array is implausible (arraystart is NULL, elements*membersize overflows, or calculating the byte offset of the last element overflows), return 0. 💀
• If the first or last element of the array points before or after the buffer, return 0. 😭
• Otherwise, return 1. ✅ slay!!!

🌈 SEE ALSO 🌈

rangecheck(3)

okay that's the whole page bestie, you ate that 🎀 this was range_arrayinbuf(3) from the Library Functions Manual, and yes the title is literally just range_arrayinbuf(3) again at the bottom because manpages are nothing if not consistent 💅 go be safe with your buffers, ily, bye ✨🦋🌸