Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_ref_ustr(3)		    Library Functions Manual		  al_ref_ustr(3)

NAME
     al_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 ALLE-
     GRO_USTR(3) string.  The information about the string  (e.g. its  size)  is
     stored  in  the structure pointed to by the info parameter.  The new 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 re-
     quired.

     The referenced interval is [start_pos, end_pos).  Both are byte offsets.

     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.

SEE ALSO
     al_ref_cstr(3), al_ref_buffer(3)

Allegro reference manual					  al_ref_ustr(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=al_ref_ustr&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help