v7 man page for ustrzcpy

ustrzcpy(3alleg4)						  Allegro manual						 ustrzcpy(3alleg4)

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)

Allegro 							   version 4.4.2						 ustrzcpy(3alleg4)