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

NAME

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

SYNOPSIS

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

DESCRIPTION

16       This function copies `src' (including the terminating  null  character)
17       into  `dest', whose length in bytes is specified by `size' and which is
18       guaranteed to be null-terminated even if `src' is bigger than `size'.
19
20       Note that, even for empty strings, your destination string must have at
21       least  enough  bytes  to  store  the  terminating null character of the
22       string, and your parameter size must reflect this. Otherwise, the debug
23       version  of Allegro will abort at an assertion, and the release version
24       of Allegro will overrun the destination buffer.
25

RETURN VALUE

27       Returns the value of `dest'.
28
29

SEE ALSO

31       uconvert(3), ustrcpy(3), ustrzncpy(3), ex3buf(3), exgui(3)
32
33
34
35Allegro                          version 4.2.2                     ustrzcpy(3)
Impressum