GRAPHEME_TO_UPPERCASE(3)

📦 version 3.0.0, in nixos 26.05, nixpkgs unstable

🎀 grapheme_to_uppercase(3) — Library Functions Manual, but make it main-character 🎀

Okay bestie, welcome to the uppercase glow-up corner of the manual. This is from the Library Functions Manual, and it's giving codepoint transformation realness. 💅

✨ NAME ✨

grapheme_to_uppercase — convert codepoint array to uppercase, literally no cap

🫶 SYNOPSIS 🫶

#include <grapheme.h>

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

💖 DESCRIPTION 💖

The grapheme_to_uppercase() function converts the codepoint array str to uppercase and writes the result to dest up to destlen, unless dest is set to NULL. Yes, str is right there in the description — we keep the lore exactly as it is. 🦋

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. That's the size-limit slay right there. ✨

For UTF-8-encoded input data grapheme_to_uppercase_utf8(3) can be used instead. iykyk, different function for a different encoding vibe. 🎀

🎀 RETURN VALUES 🎀

The grapheme_to_uppercase() function returns the number of codepoints in the array resulting from converting src to uppercase, even if destlen is not large enough or dest is NULL. It still tells you the count, periodt. 💖

🌈 SEE ALSO 🌈

⭐ STANDARDS ⭐

grapheme_to_uppercase() is compliant with the Unicode 17.0.0 specification. Certified Unicode 17.0.0 compliant, no cap. ✅

👑 AUTHORS 👑

  • Laslo Hunhold <dev@frign.de> — the icon behind this one 👑

Made with 💖 by <strong>suckless.org</strong> · <strong>2022-10-06</strong> · <strong>GRAPHEME_TO_UPPERCASE(3)</strong> — k bye bestie, go uppercase something cute 🦋✨

📦 where this page comes from