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-characters). If the return value is greater than or equal to SIZ, then truncation occurred and not all wide characters from SRC were appended.

PORTABILITY
No supporting OS subroutines are required.

SEE ALSO
wcslcat is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.