DragonFly On-Line Manual Pages

Search: Section:  

al_ref_ustr(3)                                                  al_ref_ustr(3)


al_ref_ustr - Allegro 5 API


#include <allegro5/allegro.h> const ALLEGRO_USTR *al_ref_ustr(ALLEGRO_USTR_INFO *info, const ALLEGRO_USTR *us, int start_pos, int end_pos)


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_offset(3) to find the byte offsets.


al_ref_cstr(3), al_ref_buffer(3) Allegro reference manual al_ref_ustr(3)

Search: Section: