### wcsncat -- Concatenate Wide-Character Strings

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>