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_cstr_dup

char *al_cstr_dup(const ALLEGRO_USTR *us) Introduced in 5.0.0

Create a NUL ('\0') terminated copy of the string. Any embedded NUL bytes will still be presented in the returned string. The new string must eventually be freed with al_free. If an error occurs NULL is returned.