Syntax

#include <wchar.h>
wchar_t *wcsncat(wchar_t *string1, const wchar_t *string2, size_t count);

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.

wcsncat returns string1.

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 <wchar.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
  
• strcat
  
• wcscat
  
• wcsncmp
  
• wcsncpy

---

[Back] [Next]