wcsncpy()

copy part of wide character string 

Function

SYNOPSIS

#include <wchar.h>

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

DESCRIPTION

The wcsncpy() function copies 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 n is less than or equal to the ws2, a NULL character is not automatically appended to the result. However, if n is greater than the length of ws2, then the result is padded with NULL characters up to the length of n. If the objects used for copying overlap, the behavior is undefined.

PARAMETERS

ws1 

Is the destination string.

ws2 

Is the source string.

n 

Is the number of characters to copy.

RETURN VALUES

The wcsncpy() 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(), wcsncat(), wcsncmp(), wcsrchr(), wcsspn()

PTC MKS Toolkit 10.5 Documentation Build 40.