wcsncpy(3C)

wcsncpy -- copy a wide character string with bound

Synopsis

#include <wchar.h>

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

Description

wcsncpy copies exactly n wide characters, truncating the wide string ws2 or adding null wide characters to ws1, if necessary. Wide characters that follow a null wide character are not copied. The result will not be null-terminated if the length of ws2 is n or more. If the array ws2 points to is a wide character string that is shorter than n wide characters, the copy in the array pointed to by ws1 is padded with null wide characters until a total of n wide characters is written. This function does not check for an overflow condition of the array pointed to by ws1.

Return values

wcsncpy returns ws1.

Usage

Overlapping moves may cause unexpected results because the movement of wide characters is implementation-dependent. If there is no null wide character in the first n wide characters of the array pointed to by ws2, the result will not be null-terminated.

References

wchar(5), wcscpy(3C)