Format
#include <wcstr.h> wchar_t *wcsncat(wchar_t *string1, const wchar_t *string2, size_t count);
Language Level: XPG4
wcsncat appends up to count wide characters from string2
to the end of string1, and appends a wchar_t null
character to the result.
wcsncat operates on null-terminated wide-character strings; string arguments to this function should contain a wchar_t null character marking the end of the string.
Return Value
wcsncat returns string1.
Example
This example demonstrates the difference between wcscat
and wcsncat. wcscat appends the entire second string to the
first; wcsncat appends only the specified number of characters in
the second string to the first.
#include <stdio.h> #include <wcstr.h>
#define SIZE 40
int main(void)
{
wchar_t buffer1[SIZE] = L"computer";
wchar_t * ptr;
/* Call wcscat with buffer1 and " program" */
ptr = wcscat( buffer1, L" program" ); printf( "wcscat : buffer1 = \"%ls\"\n", buffer1 );
/* Reset buffer1 to contain just the string "computer" again */
memset( buffer1, L'\0', sizeof( buffer1 )); ptr = wcscpy( buffer1, L"computer" );
/* Call wcsncat with buffer1 and " program" */ ptr = wcsncat( buffer1, L" program", 3 ); printf( "wcsncat: buffer1 = \"%ls\"\n", buffer1 ); return 0;
/*************************************************************
The output should be:
wcscat : buffer1 = "computer program"
wcsncat: buffer1 = "computer pr"
*************************************************************/
}
![]()
strncat -- Concatenate Strings
strcat -- Concatenate Strings
wcscat -- Concatenate Wide-Character
Strings
wcsncmp -- Compare Wide-Character
Strings
wcsncpy -- Copy Wide-Character Strings
<wcstr.h>