GRAPHEME_IS_UPPERCASE(3)

💖 GRAPHEME_IS_UPPERCASE(3) 💖

okay so bestie, this one lives in the Library Functions Manual section, and it's literally the moment your codepoint array gets a vibe check for being all-caps energy 👑

✨ NAME ✨

grapheme_is_uppercase — checks whether a codepoint array is uppercase, no cap 🫶

🌸 SYNOPSIS 🌸

#include <grapheme.h>

size_t
grapheme_is_uppercase(const uint_least32_t *str, size_t len,
    size_t *caselen);

💅 DESCRIPTION 💅

so the grapheme_is_uppercase() function checks if the codepoint array str is uppercase, and it writes the length of the matching uppercase-sequence into the integer that caselen points to — unless caselen is set to NULL, in which case it just doesn't, bestie 🙈

if len is set to SIZE_MAX (stdint.h is already included by grapheme.h, so don't even worry about it 💜), then the codepoint array src is interpreted as being NUL-terminated, and processing stops when a NUL-byte shows up. that's it, that's the rule ✨

also quick heads up: if your input data is UTF-8-encoded, you can use grapheme_is_uppercase_utf8(3) instead — she's right there, use her 🦋

🎀 RETURN VALUES 🎀

grapheme_is_uppercase() returns true if the codepoint array str is uppercase — slay — and otherwise false 😭

🔥 SEE ALSO 🔥

• grapheme_is_uppercase_utf8(3)
• libgrapheme(7)

👑 STANDARDS 👑

grapheme_is_uppercase() is compliant with the Unicode 17.0.0 specification. iconic behaviour, honestly ⭐

🦋 AUTHORS 🦋

Laslo Hunhold <dev@frign.de> — thank you for your service 🫶

and that's the whole page, bestie!! brought to you by suckless.org, dated 2022-10-06, and I hope your codepoints are uppercase and your caselen is never confusing 💖✨🎀