WCSCPY(3) | Library Functions Manual | WCSCPY(3) |
wcscpy
, wcsncpy
— copy wide strings
#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);
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.
The wcscpy
() and
wcsncpy
() functions return
dst.
strcpy(3), strlcpy(3), wcscat(3), wcslcpy(3), wmemcpy(3), wmemmove(3)
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”).
The wcscpy
() and
wcsncpy
() functions were ported from
NetBSD and first appeared in
OpenBSD 3.8.
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.
November 12, 2016 | OpenBSD-current |