1al_ref_ustr(3)                                                  al_ref_ustr(3)
2
3
4

NAME

6       al_ref_ustr - Allegro 5 API
7

SYNOPSIS

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

DESCRIPTION

15       Create  a read-only string that references the storage of another ALLE‐
16       GRO_USTR(3) string.  The information about the string (e.g.  its  size)
17       is  stored  in the structure pointed to by the info parameter.  The new
18       string will not have any other storage allocated of its own, so if  you
19       allocate the info structure on the stack then no explicit "free" opera‐
20       tion is required.
21
22       The referenced interval is [start_pos, end_pos).  Both  are  byte  off‐
23       sets.
24
25       The  string  is  valid  until  the underlying string is modified or de‐
26       stroyed.
27
28       If you need a range of code-points instead of bytes,  use  al_ustr_off‐
29       set(3) to find the byte offsets.
30

SEE ALSO

32       al_ref_cstr(3), al_ref_buffer(3)
33
34
35
36Allegro reference manual                                        al_ref_ustr(3)
Impressum