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_ncompare

int al_ustr_ncompare(const ALLEGRO_USTR *us1, const ALLEGRO_USTR *us2, int n) Introduced in 5.0.0

Like al_ustr_compare but only compares up to the first n code points of both strings.

Returns zero if the strings are equal, a positive number if us1 comes after us2, else a negative number.

Examples: ex_utf8