WCSLCAT(3) NEWLIB WCSLCAT(3)NAME
7.14 `wcslcat'--concatenate wide-character strings to specified length
SYNOPSIS
#include <wchar.h>
size_t wcslcat(wchar_t *DST, const wchar_t *SRC, size_t SIZ);
DESCRIPTION
The `wcslcat' function appends wide characters from SRC to end of the
DST wide-character string so that the resultant wide-character string
is not more than SIZ wide characters including the terminating null
wide-character code. A terminating null wide character is always added
unless SIZ is 0. Thus, the maximum number of wide characters that can
be appended from SRC is SIZ - 1. If copying takes place between objects
that overlap, the behaviour is undefined.
RETURNS
Wide-character string length of initial DST plus the wide-character
string length of SRC (does not include terminating null wide-charac‐
ters). If the return value is greater than or equal to SIZ, then trun‐
cation occurred and not all wide characters from SRC were appended.
PORTABILITY
No supporting OS subroutines are required.
SEE ALSOwcslcat is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 WCSLCAT(3)