wcsncat

Appends a specified number of characters of one wide-character string to another string.

Library:LibC
Classification:ANSI
Service:Characters and Strings

Syntax

  #include <wchar.h> 
   
  wchar_t   *wcsncat (
     wchar_t         *ws1,
     const wchar_t   *ws2,
     size_t           n);

Parameters

ws1

(OUT) Points to the wide-character string to which to append the characters.

ws2

(IN) Points to the string containing the wide characters to append.

n

(IN) Specifies the maximum number of wide characters to append.

Return Values

Returns ws1.

Remarks

The wcsncat function appends not more than n characters of the string pointed to by ws2 to the end of the string pointed to by ws1. The null-terminating character in ws2 or any characters following it are not appended to ws1. The first character of ws2 overwrites the null-terminating character at the end of ws1. A null-terminating character is always appended to the result.

See Also

wcscat