GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AL_CSTR (3)

NAME

al_cstr - Allegro 5 API

CONTENTS

Synopsis
Description
See Also

SYNOPSIS

C]
#include <allegro5/allegro.h>

const char *al_cstr(const ALLEGRO_USTR *us) ]

DESCRIPTION

Get a C]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:
[bu] ALLEGRO_USTRs are allowed to contain embedded NUL ([aq][aq]) bytes. That means C]al_ustr_size(u)] and C]strlen(al_cstr(u))] may not agree.
[bu] An ALLEGRO_USTR may be created in such a way that it is not NUL terminated. 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 I]not] be NUL terminated.
[bu] 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)

Search for    or go to Top of page |  Section 3 |  Main Index


Allegro reference manual AL_CSTR (3)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.