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
23       debug  version  of  Allegro will abort at an assertion, and the release
24       version 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.4.3                     ustrzcpy(3)
Impressum