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
1
2
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)