WCSNCPY

NAME

wcsncpy - copy a fixed-size string of wide characters

SYNOPSIS

#include <wchar.h>

wchar_t *wcsncpy(wchar_t *dest, const wchar_t *src, size_t n);

DESCRIPTION

The fBwcsncpyfP function is the wide-character equivalent of the fBstrncpyfP function. It copies at most fInfP wide characters from the wide-character string pointed to by fIsrcfP, including the terminating L' ' character, to the array pointed to by fIdestfP. Exactly fInfP wide characters are written at fIdestfP. If the length fIwcslen(src)fP is smaller than fInfP, the remaining wide characters in the array pointed to by fIdestfP are filled with L' ' characters. If the length fIwcslen(src)fP is greater or equal to fInfP, the string pointed to by fIdestfP will not be L' ' terminated.

The strings may not overlap.

The programmer must ensure that there is room for at least fInfP wide characters at fIdestfP.

RETURN VALUE

fBwcsncpyfP returns fIdestfP.

CONFORMING TO

ISO/ANSI C, UNIX98