al_ref_ustr(3)al_ref_ustr(3)NAMEal_ref_ustr - Allegro 5 API
SYNOPSIS
#include <allegro5/allegro.h>
const ALLEGRO_USTR *al_ref_ustr(ALLEGRO_USTR_INFO *info, const ALLEGRO_USTR *us,
int start_pos, int end_pos)
DESCRIPTION
Create a read-only string that references the storage of another
string. The information about the string (e.g. its size) is stored in
the structure pointed to by the info parameter. The string will not
have any other storage allocated of its own, so if you allocate the
info structure on the stack then no explicit "free" operation is
required.
The referenced interval is [start_pos, end_pos).
The string is valid until the underlying string is modified or
destroyed.
If you need a range of code-points instead of bytes, use al_ustr_off‐
set(3) to find the byte offsets.
SEE ALSOal_ref_cstr(3), al_ref_buffer(3)Allegro reference manualal_ref_ustr(3)