TERMKEY_SET_BUFFER_SIZE(3)

💖 TERMKEY_SET_BUFFER_SIZE(3) 💖

okay bestie, welcome to the Library Functions Manual ✨ this one's short and sweet, it's literally just about how big the buffer inside your termkey thing is. two lil functions, one job. we love a focused queen 👑

🌸 NAME 🌸

termkey_set_buffer_size, termkey_get_buffer_size — control the buffer size 🎀

✨ SYNOPSIS ✨

#include <termkey.h>

int termkey_set_buffer_size(TermKey *tk, size_t size);
size_t termkey_get_buffer_size(TermKey *tk);

Link with -ltermkey.

don't forget the link flag bestie, the linker will NOT be forgiving 😭

🦋 DESCRIPTION 🦋

so termkey_set_buffer_size() changes the size of the buffer space inside your termkey(7) instance to whatever size you hand it. glow-up for your buffer, no cap 💅

and here's the cute part: any bytes still pending in the buffer are preserved when you resize 🫶 but — and this is the plot twist — they get truncated if your new size is smaller than the total number of bytes currently chillin' in the buffer. so if you shrink it too hard, data goes poof. be mindful, queen 🙈

then termkey_get_buffer_size() just tells you the size of the buffer set by the last call to termkey_set_buffer_size(). and if you never called it? it returns the default initial size of 256 bytes. the factory setting. the OG. periodt ⭐

👑 RETURN VALUE 👑

• termkey_set_buffer_size() returns a true value, or zero if an error occurs. so like, zero = it's giving error energy 💀
• termkey_get_buffer_size() returns the current buffer size in bytes. simple. iconic. no notes ✨

🌈 SEE ALSO 🌈

• termkey_new(3)
• termkey_get_buffer_remaining(3)
• termkey(7)

go read those next bestie, they're all in the same friend group 🧚💜

k byeeee 💖 this was TERMKEY_SET_BUFFER_SIZE(3) from the Library Functions Manual — that's the whole source/version vibe we got, and no date on this one so I'm not gonna make one up, slay responsibly ✨🎀🦋