| ustrzcpy(3alleg4) | Allegro manual | ustrzcpy(3alleg4) |
ustrzcpy - Copies a string into another one, specifying size. Allegro game programming library.
#include <allegro.h>
char *ustrzcpy(char *dest, int size, const char *src);
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.
Returns the value of `dest'.
uconvert(3alleg4), ustrcpy(3alleg4), ustrzncpy(3alleg4), ex3buf(3alleg4), exgui(3alleg4)
| version 4.4.2 | Allegro |