Provided by: allegro4-doc_4.4.2-10_all bug

NAME

       ustrzcpy  -  Copies  a  string into another one, specifying size. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       char *ustrzcpy(char *dest, int size, const char *src);

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.

RETURN VALUE

       Returns the value of `dest'.

SEE ALSO

       uconvert(3alleg4), ustrcpy(3alleg4), ustrzncpy(3alleg4), ex3buf(3alleg4), exgui(3alleg4)