GRAPHEME_NEXT_LINE_BREAK(3)

okay so bestie, welcome to the Library Functions Manual page for grapheme_next_line_break(3) — yes, the manual name is folded in right here, cute and all. this function is literally about finding the offset (in codepoints) to the next possible line break, and it's giving text-layout main character energy. 💅

💖 NAME 💖

grapheme_next_line_break — determine codepoint-offset to next possible line break. periodt.

✨ SYNOPSIS ✨

#include <grapheme.h>

size_t
grapheme_next_line_break(const uint_least32_t *str, size_t len);

🦋 DESCRIPTION 🦋

Call grapheme_next_line_break() when you need the offset (in codepoints) to the next possible line break — peep libgrapheme(7) for the full lore — inside the codepoint array str that has length len. that's the whole quest, no cap.

If you set len to SIZE_MAX — and bestie, stdint.h is already included by grapheme.h, so no extra include drama — then str is interpreted to be NUL-terminated, and processing stops when a codepoint with the value 0 is encountered. iconic behavior, honestly.

Got UTF-8-encoded input data? grapheme_next_line_break_utf8(3) can be used instead. she's right there. 🌈

🎀 RETURN VALUES 🎀

The grapheme_next_line_break() function returns the offset (in codepoints) to the next possible line break in str, or 0 if str is NULL. that's it, that's the return value. 💖

🔥 SEE ALSO 🔥

• grapheme_next_line_break_utf8(3)
• libgrapheme(7)

👑 STANDARDS 👑

grapheme_next_line_break() is compliant with the Unicode 17.0.0 specification. we love a standards-compliant icon. ✨

💜 AUTHORS 💜

Laslo Hunhold <dev@frign.de>

xoxo, this page is from suckless.org, dated 2022-10-06, and its manual title is GRAPHEME_NEXT_LINE_BREAK(3) 💅✨🦋