array_fail(3)

🌸 NAME 🌸

okay so bestie, this page is array_fail(3) from the Library Functions Manual, and it does exactly one thing: it switches your array to have failed 💅

✨ SYNTAX ✨

first, the vibe check — pull in the header:

#include <libowfat/array.h>

the actual call:

void array_fail(array* x);

and here's how you'd fr use it on a real array:

array x;
array_fail(&x);

💖 DESCRIPTION 💖

okay so it all depends on what state your x is in, and there are literally three moods 👑

• if x is allocated — array_fail frees the region that x points to, and then switches x to have failed. bye bye memory, hello failure 🫶
• if x is unallocated — no freeing needed, it just switches x to have failed. simple. clean. iconic.
• if x has already failed — array_fail has no effect. she's already there, nothing left to do, no notes 💀

ngl the third one is giving "we been knew" energy — failing twice isn't a thing, it's just a no-op ✨

🦋 SEE ALSO 🦋

go read these next, they're the rest of the friend group:

• array_allocate(3)
• array_reset(3)

and that's the whole page, bestie 🎀 that's it, that's the function — short, sweet, and honestly kind of a slay. this was array_fail(3) from the Library Functions Manual, and no date on the original footer so she's lowkey timeless 💜 bye mwah 🦋