wcscpy - copy a wide-character string
Contents
Attributes
For an explanation of the terms used in this section, see attributes(7).
┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
│ Interface │ Attribute │ Value │
├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
│ wcscpy() │ Thread safety │ MT-Safe │
└─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘
Description
The wcscpy() function is the wide-character equivalent of the strcpy(3) function. It copies the wide-
character string pointed to by src, including the terminating null wide character (L'\0'), to the array
pointed to by dest.
The strings may not overlap.
The programmer must ensure that there is room for at least wcslen(src)+1 wide characters at dest.
History
POSIX.1-2001, C99.
Library
Standard C library (libc, -lc)
Name
wcscpy - copy a wide-character string
Return Value
wcscpy() returns dest.
See Also
strcpy(3), wcpcpy(3), wcscat(3), wcsdup(3), wmemcpy(3) Linux man-pages 6.9.1 2024-06-15 wcscpy(3)
Standards
C11, POSIX.1-2008.
Synopsis
#include<wchar.h>wchar_t*wcscpy(wchar_t*restrictdest,constwchar_t*restrictsrc);