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"	opera-
       tion is required.

       The  referenced	interval  is [start_pos, end_pos).  Both are byte off-
       sets.

       The string is valid until the underlying	 string	 is  modified  or  de-
       stroyed.

       If  you	need a range of	code-points instead of bytes, use al_ustr_off-
       set(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+14.3.quarterly>

home | help