Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ustrzncpy(3)			 Allegro manual 		    ustrzncpy(3)

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' whose length in	bytes  is  specified  by
     `size'  and which is guaranteed to be null-terminated even if `src' is big-
     ger than `size'. 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)

Allegro 			  version 4.4.3 		    ustrzncpy(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ustrzncpy&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help