array_truncate(3)

💖 array_truncate — the manual page, bestie edition 💖

okay so this is array_truncate(3) from the Library Functions Manual and it's literally the glow-down your array asked for ✨

✨ NAME ✨

array_truncate — reduce number of initialized bytes 🎀

🌸 SYNTAX 🌸

#include <libowfat/array.h>

void array_truncate(array* x, uint64 membersize, int64 len);

  array_truncate(&x,sizeof(t),len);

🦋 DESCRIPTION 🦋

okay so picture this: your array x has been out here living its best life, all these initialized bytes, and you're like… bestie, we need to cut. array_truncate reduces the number of initialized bytes in x to exactly len*sizeof(t). iconic. no cap. 💅

and here's the part where it's lowkey the chillest function ever, because it does literally nothing in like four whole situations:

• if the number of initialized bytes was already this small (or smaller) — no effect 🫶
• if len is negative — no effect 🫶
• if x is unallocated — no effect 🫶
• if x has failed — no effect 🫶

like, it's giving "I'm not gonna make it worse, I'm just gonna not do anything." main character energy, honestly. 💀

IMPORTANT: array_truncate does not change the allocation in x. nope. the memory is still there, still vibing, still yours. so if you actually want to free the memory used by x, you need to go use array_reset instead. different function, different vibe, don't mix them up bestie 😭

🌈 SEE ALSO 🌈

• array_allocate(3)
• array_get(3)
• array_fail(3)
• array_trunc(3)
• array_reset(3)

and that's the whole page fr fr 🍓 this was array_truncate(3) hanging out under the Library Functions Manual banner, and yes the footer is just the name again because the manpage said so and we respect the manpage 👑 go forth and truncate responsibly, bestie 🧚💜