1ustrzncpy(3)                    Allegro manual                    ustrzncpy(3)
2
3
4

NAME

6       ustrzncpy  - Copies a string into another one, specifying size. Allegro
7       game programming library.
8

SYNOPSIS

10       #include <allegro.h>
11
12
13       char *ustrzncpy(char *dest, int size, const char *src, int n);
14

DESCRIPTION

16       This function is like ustrzcpy() except that no more than  `n'  charac‐
17       ters  from  `src'  are copied into `dest'. If `src' is shorter than `n'
18       characters, null characters are appended to `dest' as padding until `n'
19       characters  have  been written. In any case, `dest' is guaranteed to be
20       null-terminated.
21
22       Note that, even for empty strings, your destination string must have at
23       least  enough  bytes  to  store  the  terminating null character of the
24       string, and your parameter `size' must  reflect  this.  Otherwise,  the
25       debug  version  of  Allegro will abort at an assertion, and the release
26       version of Allegro will overrun the destination buffer.
27

RETURN VALUE

29       The return value is the value of `dest'.
30
31

SEE ALSO

33       uconvert(3), ustrzcpy(3), ustrncpy(3), exkeys(3)
34
35
36
37Allegro                          version 4.2.3                    ustrzncpy(3)