buffer_get_token(3)

💖 buffer_get_token(3) 💖

okay bestie, welcome to the Library Functions Manual — today's main character is buffer_get_token, and she is literally the token-grabbing queen 👑✨

🌸 NAME 🌸

buffer_get_token — read token from buffer 🎀

✨ SYNTAX ✨

#include <libowfat/buffer.h>

ssize_t buffer_get_token(buffer* b,char* x,size_t len,
                 const char* charset,size_t setlen);

like. she's giving five arguments and zero apologies 💅

🦋 DESCRIPTION 🦋

okay so here's the vibe 🫶 — buffer_get_token copies data from b over into x[0], x[1], ..., x[len-1], and she keeps going until either:

• len bytes have been copied, or
• one of charset[0], charset[1], ..., charset[setlen] equals the last byte that was read 🔥

basically she's slurping bytes until she hits a character you told her is a stopping point, or until the destination is full. no cap.

then she returns the number of bytes read 📏 — or -1 on error, and when that happens she sets errno appropriately, because she's messy but she's accountable 😭💀

👀 SEE ALSO 👀

• buffer_init(3)
• buffer_feed(3)
• buffer_peek(3)
• buffer_seek(3)
• buffer(3)

go read those too, they're all part of the same friend group fr fr 🧚

and that's the whole page, bestie 🌈 this lil cutie came from the Library Functions Manual, and she goes by buffer_get_token(3) — periodt 💖✨🎀