function
<cwchar>
wcsncat
wchar_t* wcsncat (wchar_t* destination, const wchar_t* source, size_t num);
Append characters from wide string
Appends the first num wide characters of source to destination, plus a terminating null wide character.
If the length of the C wide string in source is less than num, only the content up to the terminating null wide character is copied.
This is the wide character equivalent of strncat (<cstring>).
Parameters
- destination
- Pointer to the destination array, which should contain a C wide string, and be large enough to contain the concatenated resulting string, including the additional null wide character.
- source
- C wide string to be appended.
- num
- Maximum number of characters to be appended.
 size_t is an unsigned integral type.
Return Value
destination is returned.
Example
| 12
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 
 | /* wcsncat example */
#include <wchar.h>
int main ()
{
  wchar_t wcs1[20];
  wchar_t wcs2[20];
  wcscpy ( wcs1, L"To be " );
  wcscpy ( wcs2, L"or not to be" );
  wcsncat ( wcs1, wcs2, 6 );
  wprintf ( L"%ls\n", wcs1);
  return 0;
}
 | 
Output:
See also
- strncat
- Append characters from string (function
)
- wcscat
- Concatenate wide strings (function
)
- wcsncpy
- Copy characters from wide string (function
)
- wmemcpy
- Copy block of wide characters (function
)