DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

wcscat(S)


wcscat, wcsncat -- concatenate two wide character strings

Syntax

cc . . . -lc

#include <wchar.h>

wchar_t *wcscat(wchar_t *ws1, const wchar_t *ws2); wchar_t *wcsncat(wchar_t *ws1, const wchar_t *ws2, size_t n);

Description

wcscat(S) appends a copy of the wide character string pointed to by ws2 to the end of the wide character string pointed to by ws1.

wcsncat(S) appends a copy of wide-character codes in the array pointed to by ws2 to the end of the wide character string pointed to by ws1. At most, n wide-character codes in ws2 are appended. If there is a null wide-character code in the first n characters in ws2, the null wide-character code and all other wide-character codes after it are are not appended.

The null terminating wide-character at the end of ws1 is overwritten by the first wide-character code in ws2. The result is always padded by a terminating null wide-character code.

If copying takes place in overlapping memory blocks, the behavior is not defined.

Return values

wcscat( ) and wcsncat( ) return ws1; no error return value is reserved.

Diagnostics

The value of errno is undefined.

See also

iswctype(S), wctype(S)

Standards conformance

wcscat( ) and wcsncat( ) are conformant with:
X/Open CAE Specification, System Interfaces and Headers, Issue 4, 1992.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003