GRAPHEME_TO_LOWERCASE(3) - Library Functions Manual

NAME

grapheme_to_lowercase - convert codepoint array to lowercase

SYNOPSIS

#include <grapheme.h>

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

DESCRIPTION

The grapheme_to_lowercase() function converts the codepoint array str to lowercase and writes the result to dest up to destlen, unless dest is set to NULL.

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.

For UTF-8-encoded input data grapheme_to_lowercase_utf8(3) can be used instead.

RETURN VALUES

The grapheme_to_lowercase() function returns the number of codepoints in the array resulting from converting src to lowercase, even if destlen is not large enough or dest is NULL.

SEE ALSO

grapheme_to_lowercase_utf8(3), libgrapheme(7)

STANDARDS

grapheme_to_lowercase() is compliant with the Unicode 15.0.0 specification.

AUTHORS

Laslo Hunhold (dev@frign.de)

suckless.org - 2022-10-06