buffer_get...en_sa_pred(3)

💖 NAME 💖

buffer_get_new_token_sa_pred — bestie, this one reads a token from a buffer 🎀

So this is a page from the Library Functions Manual, and it's giving "grab me a token, but make it custom." Let's get into it 🫶

✨ SYNTAX ✨

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

int buffer_get_new_token_sa_pred(buffer* b, stralloc* sa,
                 int (*predicate)(stralloc* * sa));

🌸 DESCRIPTION 🌸

okay so. buffer_get_token_sa_pred copies data from b to sa until predicate(sa) returns 1 or -1. That's the whole vibe 💅

If predicate returns 1 once a '\n' was read, that new-line character is still appended to sa — no cap, it's just sitting there 🙈 so use stralloc_chop or stralloc_chomp to get rid of it. And predicate can also return:

• 0 — meaning further input is required to complete the token (we're not done yet, keep waiting bestie ⏳)
• -1 — meaning abort and return -1. Use this if predicate wants to enforce a maximum message size, or does timeout handling, or detects a malformed message 🚩

If reading from the buffer or allocating memory fails, buffer_get_new_token_sa_pred returns -1 and sets errno appropriately 😭 and at that point sa may already contain a partial token — so heads up, it's not clean in there.

On success, buffer_get_new_token_sa_pred returns 0 ✨

If you want to read from a non-blocking socket, use buffer_get_token_sa_pred instead. Periodt 🔥

🦋 SEE ALSO 🦋

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

and that's the page, bestie 💖 this one lives in the Library Functions Manual and signs off as buffer_get...en_sa_pred(3) — no version, no date, just vibes 🌈 go read those SEE ALSOs, iykyk 👑