The Open Group Base Specifications Issue 7, 2018 edition
IEEE Std 1003.1-2017 (Revision of IEEE Std 1003.1-2008)
Copyright © 2001-2018 IEEE and The Open Group
NAME
wcscat - concatenate two wide-character strings
SYNOPSIS
#include <wchar.h>
wchar_t *wcscat(wchar_t *restrict ws1, const wchar_t *restrict ws2);
DESCRIPTION
[CX] ![[Option Start]](../images/opt-start.gif)
The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the
requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2017 defers to the ISO C
standard.
![[Option End]](../images/opt-end.gif)
The wcscat() function shall append a copy of the wide-character string pointed to by ws2 (including the
terminating null wide-character code) to the end of the wide-character string pointed to by ws1. The initial wide-character
code of ws2 shall overwrite the null wide-character code at the end of ws1. If copying takes place between objects
that overlap, the behavior is undefined.
RETURN VALUE
The wcscat() function shall return ws1; no return value is reserved to indicate an error.
ERRORS
No errors are defined.
The following sections are informative.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
wcsncat
XBD <wchar.h>
CHANGE HISTORY
First released in Issue 4. Derived from the MSE working draft.
Issue 6
The Open Group Corrigendum U040/2 is applied. In the RETURN VALUE section, s1 is changed to ws1.
The wcscat() prototype is updated for alignment with the ISO/IEC 9899:1999 standard.
End of informative text.
return to top of page
UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2018 IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT
]