Text::GetGlyphCountUTF8

Defined in: C4String.h

Returns the number of UTF-8 glyphs in a character string.

Prototype

int32 GetGlyphCountUTF8(const char *text);

Parameters

text A pointer to a null-terminated character string.

Description

The GetGlyphCountUTF8 function returns the number of individual glyphs encoded as UTF-8 in the string specified by the text parameter. This number is at most the number of bytes occupied by the string, but it is less for strings containing multi-byte characters. Each character is counted as one glyph regardless of the number of bytes it occupies.

The string must be null-terminated by a zero byte. The null terminator is not included in the length.