NAME

wcscpy, wcsncpy — copy wide strings

SYNOPSIS

#include <wchar.h>

wchar_t *
wcscpy(wchar_t * restrict dst, const wchar_t * restrict src);

wchar_t *
wcsncpy(wchar_t * restrict dst, const wchar_t * restrict src, size_t len);

DESCRIPTION

The wcscpy() and wcsncpy() functions copy the wide string src to dst (including the terminating null wide character).

The wcsncpy() function copies not more than len wide characters to dst, appending null wide characters if the length of src is less than len, and not terminating dst if the length of src is greater than or equal to len.

If the src and dst strings overlap, the behavior is undefined.

RETURN VALUES

The wcscpy() and wcsncpy() functions return dst.

SEE ALSO

strcpy(3), strlcpy(3), wcscat(3), wcslcpy(3), wmemcpy(3), wmemmove(3)

STANDARDS

The wcscpy() and wcsncpy() functions conform to ISO/IEC 9899:1999 (“ISO C99”) and were first introduced in ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”).

HISTORY

The wcscpy() and wcsncpy() functions were ported from NetBSD and first appeared in OpenBSD 3.8.

CAVEATS

Using the functions wcscpy() and wcsncpy() is very error-prone with respect to buffer overflows; see the EXAMPLES section in strncpy(3) for correct usage. Using wcslcpy(3) is a better choice in most cases.