GRAPHEME_NEXT_CHARACTER_BREAK(3)

💖 NAME 💖

Hiii bestie! 💖 This page lives in the Library Functions Manual, and the header title is GRAPHEME_NEXT_CHARACTER_(3). Today we're talking about grapheme_next_character_break() — your little helper for finding the next grapheme cluster break. 🫶

• grapheme_next_character_break — determine the codepoint-offset to the next grapheme cluster break ✨💅

---

🦋 SYNOPSIS 🦋

Okay, formal fit check time:

#include <grapheme.h>

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

---

✨ DESCRIPTION ✨

Okay so here's the tea: grapheme_next_character_break() computes the offset (in codepoints) to the next grapheme cluster break — peep libgrapheme(7) if you wanna know more — inside the codepoint array str of length len. If a grapheme cluster begins right at str, that offset is literally equal to the length of said grapheme cluster. 💖

Now, if len is set to SIZE_MAX (stdint.h is already included by grapheme.h, no extra homework), then str is interpreted as NUL-terminated, and processing stops when it encounters a codepoint with the value 0. 🛑

For UTF-8-encoded input data, bestie, you can use grapheme_next_character_break_utf8(3) instead. That's the sibling function. 🦋

---

🎀 RETURN VALUES 🎀

grapheme_next_character_break() returns the offset (in codepoints) to the next grapheme cluster break in str, or 0 if str is NULL. That's the whole return vibe check. 🎀

---

🌈 SEE ALSO 🌈

Go give these a look, iykyk:

• grapheme_is_character_break(3)
• grapheme_next_character_break_utf8(3)
• libgrapheme(7)

---

⭐ STANDARDS ⭐

grapheme_next_character_break() is compliant with the Unicode 17.0.0 specification. Standards? Ate. ⭐

---

👑 AUTHORS 👑

Shoutout to Laslo Hunhold <dev@frign.de> for this one. 👑

---

Cute little sign-off: this page's source/version is suckless.org, and it's dated 2022-10-06. The page title is GRAPHEME_NEXT_CHARACTER_BREAK(3). Mwah 💋