al_cstr man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

al_cstr(3)							    al_cstr(3)

NAME
       al_cstr - Allegro 5 API

SYNOPSIS
	      #include <allegro5/allegro.h>

	      const char *al_cstr(const ALLEGRO_USTR *us)

DESCRIPTION
       Get  a  char * pointer to the data in a string.	This pointer will only
       be valid while the underlying string is not modified and not destroyed.
       The  pointer may be passed to functions expecting C-style strings, with
       the following caveats:

       · ALLEGRO_USTRs are allowed to contain embedded NUL ('')	 bytes.	  That
	 means al_ustr_size(u) and strlen(al_cstr(u)) may not agree.

       · An  ALLEGRO_USTR may be created in such a way that it is not NUL ter‐
	 minated.  A string which is dynamically allocated will always be  NUL
	 terminated,  but  a  string  which  references	 the middle of another
	 string or region of memory will not be NUL terminated.

       · If the ALLEGRO_USTR references another string, the returned C	string
	 will point into the referenced string.	 Again, no NUL terminator will
	 be added to the referenced string.

SEE ALSO
       al_ustr_to_buffer(3), al_cstr_dup(3)

Allegro reference manual					    al_cstr(3)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net