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'  charac-
       ters  from `src'	are copied into	`dest' whose length in bytes is	speci-
       fied by `size' and which	is guaranteed to be  null-terminated  even  if
       `src'  is  bigger 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-termi-
       nated.

       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 de-
       bug version of Allegro will abort at an assertion, and the release ver-
       sion 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.2			  ustrzncpy(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

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

home | help