buffer_get_token_pred(3)

💖 buffer_get_token_pred(3) 💖

okay so bestie, welcome to the Library Functions Manual ✨ this one's a lil libowfat baddie that reads you a whole token off a buffer and she's honestly so iconic for it 🎀

🌸 NAME 🌸

buffer_get_token_pred — read token from buffer 👑

✨ SYNTAX ✨

lowkey just include the header and you're in, no cap:

#include <libowfat/buffer.h>

ssize_t buffer_get_token_pred(buffer* b,char* x,size_t len,
                 int (*predicate)(const char* s,size_t len));

🦋 DESCRIPTION 🦋

so here's the vibe: buffer_get_token_pred copies data from b into x[0], x[1], ..., x[len-1] — literally one byte at a time, main character energy — and it keeps going until either

• len bytes have been read, or
• predicate gets called on the destination string and returns nonzero 👀

and the way that predicate has options?? it's giving choose-your-own-adventure fr fr:

• it can return 0 — which means "bestie I need more input to finish this token, keep going" 🥺
• or it can return -1 — which means abort and return -1 💀 use this when predicate wants to enforce a maximum message size, or does timeout handling, or detects a malformed message. periodt.

then buffer_get_token_pred returns the number of bytes copied 🫶 or -1 on error (and yes, it sets errno appropriately, she's polite like that).

ngl the -1 path is a real one — if your predicate bails, the whole call bails. don't sleep on that.

🌈 SEE ALSO 🌈

go read her friends too, they're all slay:

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

and that's the whole page babes 💅 this was buffer_get_token_pred(3) from the Library Functions Manual — k bye, ily, go read a buffer 🧚💜