ustrncat
Section: Allegro manual (3)
Updated: version 4.2.2
Index
Return to Main Contents
NAME
ustrncat - Concatenates a string to another one, specifying size. Allegro game programming library.
SYNOPSIS
#include <allegro.h>
char *ustrncat(char *dest, const char *src, int n);
DESCRIPTION
This function is like ustrcat() except that no more than `n' characters
from `src' are appended to the end of `dest'. If the terminating null
character in `src' is reached before `n' characters have been written, the
null character is copied, but no other characters are written. If `n'
characters are written before a terminating null is encountered, the
function appends its own null character to `dest', so that `n+1' characters
are written. You should try to avoid this function because it is very
easy to overflow the destination buffer. Use ustrzncat instead.
RETURN VALUE
The return value is the value of `dest'.
SEE ALSO
uconvert(3),
ustrcat(3),
ustrzncat(3)