buffer_get_new_token_sa(3)

✨ buffer_get_new_token_sa ✨

okay bestie, come sit with me because we're doing libowfat tokens today and honestly? it's giving main character energy 🎀

this page lives in the Library Functions Manual (that's the manual name, iykyk), and the whole thing is literally just: read a token out of a buffer. that's it. that's the vibe. 💅

---

🌸 NAME 🌸

buffer_get_new_token_sa — read token from buffer

like. it reads a token. from a buffer. no cap. 🦋

---

✨ SYNTAX ✨

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

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

so you got your b (the buffer, the source of the tea), your sa (the stralloc, where the token lands), your charset (the delimiter squad), and your setlen (how many delimiters are actually in that squad). 🫶

---

💖 DESCRIPTION 💖

okay so here's the whole plot: buffer_get_new_token_sa copies data from the b over to sa until it bumps into one of the delimiters in charset. and the way it does this? it overwrites whatever was already chilling in sa before. not appending, not merging, not "aww let me preserve your old data" — full overwrite, periodt. 💀

and the delimiter that stopped the party? yeah, that one gets copied to sa too. it's part of the token now. iconic behavior honestly. ✨

😭 now the sad part: if reading from the buffer fails, or if allocating memory fails, buffer_get_new_token_sa returns -1 and sets errno appropriately. and listen — at that point sa may already contain a partial token. so like, don't be out here trusting sa after an error, bestie. it's half-baked. 🙈

also, real talk: if you're trying to read from a non-blocking socket, use buffer_get_token_sa instead. this one is not the one for that job. different function, different vibe. 🧚

---

🔥 RETURN VALUE 🔥

• -1 — error, and it's setting errno on the way out. 😭
• 0 — EOF. that's the end of the road, babe. 🌈
• 1 — successful. slay. we ate. 👑

---

⭐ SEE ALSO ⭐

go read these next, they're all in the same friend group:

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

---

and that's the whole page, bestie!! 🎀 no source version, no date stamp, nothing extra — the footer just echoes buffer_get_new_token_sa(3) right back at us from the Library Functions Manual like a lil mirror. cute. obsessed. go read your tokens. 💜✨