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_assign_substr

bool al_ustr_assign_substr(ALLEGRO_USTR *us1, const ALLEGRO_USTR *us2,
   int start_pos, int end_pos)

Introduced in 5.0.0

Overwrite the string us1 with the contents of us2 in the byte interval [start_pos, end_pos). The end points will be clamed to the bounds of us2.

Usually you will first have to use al_ustr_offset to find the byte offsets.

Returns true on success, false on error.

Examples: ex_utf8