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)