ustrzncpy
Section: Allegro manual (3)
Updated: version 4.2.2
Index
Return to Main Contents
NAME
ustrzncpy - Copies a string into another one, specifying size. Allegro game programming library.
SYNOPSIS
#include <allegro.h>
char *ustrzncpy(char *dest, int size, const char *src, int n);
DESCRIPTION
This function is like ustrzcpy() except that no more than `n' characters
from `src' are copied into `dest'. If `src' is shorter than `n' characters,
null characters are appended to `dest' as padding until `n' characters have
been written. In any case, `dest' is guaranteed to be null-terminated.
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
The return value is the value of `dest'.
SEE ALSO
uconvert(3),
ustrzcpy(3),
ustrncpy(3),
exkeys(3)