Manual

UTF-8 string routines

About UTF-8 string routines
UTF-8 string types
- ALLEGRO_USTR
- ALLEGRO_USTR_INFO
Creating and destroying strings
Predefined strings
- al_ustr_empty_string
Creating strings by referencing other data
Sizes and offsets
Getting code points
Inserting into strings
Appending to strings
Removing parts of strings
Assigning one string to another
Replacing parts of string
- al_ustr_set_chr
- al_ustr_replace_range
Searching
Comparing
UTF-16 conversion
Low-level UTF-8 routines
- al_utf8_width
- al_utf8_encode
Low-level UTF-16 routines
- al_utf16_width
- al_utf16_encode

al_ustr_size_utf16

size_t al_ustr_size_utf16(const ALLEGRO_USTR *us) Introduced in 5.0.0

Returns the number of bytes required to encode the string in UTF-16 (including the terminating 0). Usually called before al_ustr_encode_utf16 to determine the size of the buffer to allocate.