GRAPHEME_TO_TITLECASE_UTF8(3)

📦 version 3.0.0, in nixos 26.05, nixpkgs unstable

💖 NAME 💖

grapheme_to_titlecase_utf8 — convert UTF-8-encoded string to titlecase.

Okay bestie, welcome to the GRAPHEME_TO_TITLECASE_UTF8(3) page — this is the one that takes your UTF-8 string and gives it titlecase energy ✨

🌸 SYNOPSIS 🌸

#include <grapheme.h>

size_t
grapheme_to_titlecase_utf8(const char *src, size_t srclen, char *dest,
    size_t destlen);

🦋 DESCRIPTION 🦋

Okay so the grapheme_to_titlecase_utf8() function converts the UTF-8-encoded string str to titlecase and writes the result to dest up to destlen, unless dest is set to NULL. No cap, that's the whole gig 💅

If srclen is set to SIZE_MAX (stdint.h is already included by grapheme.h), the UTF-8-encoded string src is interpreted to be NUL-terminated and processing stops when a NUL-byte is encountered. Very “stop when you see the NUL” of it 🛑

For non-UTF-8 input data, grapheme_to_titlecase(3) can be used instead. Iconic backup plan 🫶

🔥 RETURN VALUES 🔥

The grapheme_to_titlecase_utf8() function returns the number of bytes in the array resulting from converting src to titlecase, even if destlen is not large enough or dest is NULL. It’s giving “I’ll tell you how much space you actually needed” 💀

👀 SEE ALSO 👀

🌈 STANDARDS 🌈

grapheme_to_titlecase_utf8() is compliant with the Unicode 17.0.0 specification. Periodt, Unicode-approved 👑

🎀 AUTHORS 🎀

Laslo Hunhold <dev@frign.de>

Made with love by suckless.org, dated 2022-10-06 — this was GRAPHEME_TO_TITLECASE_UTF8(3), bestie, mwah 💋

📦 where this page comes from