.\" Generated by the Allegro makedoc utility
.TH ustrzcpy 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
ustrzcpy \- Copies a string into another one, specifying size. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B char *ustrzcpy(char *dest, int size, const char *src);
.SH DESCRIPTION
This function copies `src' (including the terminating null character) into
`dest', whose length in bytes is specified by `size' and which is
guaranteed to be null-terminated even if `src' is bigger than `size'.

Note that, even for empty strings, your destination string must have at
least enough bytes to store the terminating null character of the string,
and your parameter `size' must reflect this. Otherwise, the debug version
of Allegro will abort at an assertion, and the release version of Allegro
will overrun the destination buffer.
.SH "RETURN VALUE"
Returns the value of `dest'.

.SH SEE ALSO
.BR uconvert (3alleg4),
.BR ustrcpy (3alleg4),
.BR ustrzncpy (3alleg4),
.BR ex3buf (3alleg4),
.BR exgui (3alleg4)