.\" Automatically generated by Pandoc 3.1.12.1
.\"
.TH "al_cstr_dup" "3" "" "Allegro reference manual" ""
.SH NAME
al_cstr_dup \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro.h>\f[R]

char *al_cstr_dup(const ALLEGRO_USTR *us)
.EE
.SH DESCRIPTION
Create a NUL (\f[CR]\[aq]\[rs]0\[aq]\f[R]) terminated copy of the
string.
Any embedded NUL bytes will still be presented in the returned string.
The new string must eventually be freed with al_free(3).
.PP
If an error occurs NULL is returned.
.SH SEE ALSO
al_cstr(3), al_ustr_to_buffer(3), al_free(3)