wcsncat()

concatenate part of two wide character strings 

Function


SYNOPSIS

#include <wchar.h>

wchar_t *wcsncat(wchar_t *ws1, const wchar_t *ws2, size_t n);


DESCRIPTION

The wcsncat() function appends no more than the first n characters of the string pointed to by ws2 to the end of the string pointed to by ws1. If a NULL character appears in ws2 before n characters, all characters up to the NULL character are appended to ws1. The first character of ws2 overwrites the terminating NULL character of ws1. A NULL terminating character is always appended to the result, and if the objects used for copying overlap, the behavior is undefined.


PARAMETERS

ws1 

Is the null-terminated destination string.

ws2 

Is the null-terminated source string.

n 

Is the number of characters to append.


RETURN VALUES

The wcsncat() function returns the value of ws1.


CONFORMANCE

ANSI/ISO 9899-1990/AM 1-1995.


MULTITHREAD SAFETY LEVEL

MT-Safe.


PORTING ISSUES

None.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
wcscat(), wcscmp(), wcscpy(), wcsncmp(), wcsncpy(), wcsrchr(), wcsspn()


PTC MKS Toolkit 10.4 Documentation Build 39.