GRAPHEME_TO_TITLECASE(3)

🌸 NAME 🌸

okay so bestie, this is the grapheme_to_titlecase(3) page from the Library Functions Manual — and it does exactly what it says on the tin: grapheme_to_titlecase — convert codepoint array to titlecase. iconic, honestly.

---

✨ SYNOPSIS ✨

#include <grapheme.h>

size_t
grapheme_to_titlecase(const uint_least32_t *src, size_t srclen,
    uint_least32_t *dest, size_t destlen);

---

💅 DESCRIPTION 💅

The grapheme_to_titlecase() function converts the codepoint array str to titlecase and writes the result to dest up to destlen, unless dest is set to NULL. yes, that is the whole vibe. 💖

If srclen is set to SIZE_MAX (stdint.h is already included by grapheme.h), the codepoint array src is interpreted to be NUL-terminated and processing stops when a NUL-byte is encountered. lowkey important, so don't skip that part. 🫶

For UTF-8-encoded input data, grapheme_to_titlecase_utf8(3) can be used instead. slay, there's a whole other function for that. ✨

---

🫶 RETURN VALUES 🫶

The grapheme_to_titlecase() function returns the number of codepoints in the array resulting from converting src to titlecase, even if destlen is not large enough or dest is NULL. so yeah, it still tells you the size you'd need — very main character energy. 👑

---

🦋 SEE ALSO 🦋

• grapheme_to_titlecase_utf8(3)
• libgrapheme(7)

---

🌈 STANDARDS 🌈

grapheme_to_titlecase() is compliant with the Unicode 17.0.0 specification. no cap, it's official. ⭐

---

👑 AUTHORS 👑

Laslo Hunhold <dev@frign.de>

---

made with 💖 by suckless.org · dated 2022-10-06 · straight from the Library Functions Manual, periodt 💅