buffer_get_token_sa(3)

💖 buffer_get_token_sa(3) 💖

okay bestie, welcome to the manual page for buffer_get_token_sa — she lives in the Library Functions Manual and she is so useful, no cap. this is the girl that reads a token off a buffer. let's get into it 🎀

✨ NAME ✨

buffer_get_token_sa — read token from buffer

🌸 SYNTAX 🌸

#include <libowfat/stralloc.h>
#include <libowfat/buffer.h>

int buffer_get_token_sa(buffer* b,stralloc* sa,
                    const char* charset,size_t setlen);

💅 DESCRIPTION 💅

so here's the tea. buffer_get_token_sa keeps appending data from b into sa until it hits one of the delimiters in charset, and it does NOT overwrite whatever was already chillin' in sa before. it just adds to the pile. and the delimiter that stopped it? yeah, that one gets appended to sa too. she's included, periodt. ✨

now, the sad part 😭 — if reading from the buffer fails, or if allocating memory fails, buffer_get_token_sa returns -1 and sets errno appropriately. and heads up bestie: at that exact moment, sa may already contain a partial token. so don't come for her, she tried her best 🫶

👑 RETURN VALUE 👑

• -1 — on error (and she sets errno, iconically)
• 0 — on EOF
• 1 — when successful 🎉

🦋 RATIONALE 🦋

okay so why does she append instead of overwrite? because that's literally the whole point, iykyk. appending means you can use her on non-blocking sockets 🧚 — those babies signal an error and set errno to EAGAIN. and when that happens? you literally just call buffer_get_token_sa again later, once select or poll tells you more data has arrived. it's giving main character energy with a comeback arc 💜

🌈 SEE ALSO 🌈

• buffer_getline_sa(3)
• buffer_get_token(3)
• buffer(3)

and that's the whole page, bestie 🍓 thanks for reading all the way through, you ate that. this was buffer_get_token_sa(3) from the Library Functions Manual — the page footer just shows the name again with no date on it, so that's all we've got, and honestly? iconic. bye pookie 💖✨🎀