Format
#include <wcstr.h> wchar_t *wcscat(wchar_t *string1, const wchar_t *string2);
Language Level: XPG4
Threadsafe: Yes.
Description
The wcscat() function appends a copy of the string pointed to by string2 to the end of the string pointed to by string1.
The wcscat() function operates on null-ended wchar_t strings. The string arguments to this function should contain a wchar_t null character marking the end of the string. Boundary checking is not performed.
Return Value
The wcscat() function returns a pointer to the concatenated string1.
Example that uses wcscat()
This example creates the wide character string "computer program" using the wcscat() function.
#include <stdio.h> #include <wcstr.h> #define SIZE 40 int main(void) { wchar_t buffer1[SIZE] = L"computer"; wchar_t * string = L" program"; wchar_t * ptr; ptr = wcscat( buffer1, string ); printf( "buffer1 = %ls\n", buffer1 ); } /**************** Output should be similar to: ****************** buffer1 = computer program ******************************************************************/
Related Information
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.