wcscpy(3)

1wcscpy(3)                  Library Functions Manual                  wcscpy(3)
2
3
4

NAME

6       wcscpy - copy a wide-character string
7

LIBRARY

9       Standard C library (libc, -lc)
10

SYNOPSIS

12       #include <wchar.h>
13
14       wchar_t *wcscpy(wchar_t *restrict dest, const wchar_t *restrict src);
15

DESCRIPTION

17       The wcscpy() function is the wide-character equivalent of the strcpy(3)
18       function.  It copies the wide-character string pointed to by  src,  in‐
19       cluding  the  terminating  null  wide  character  (L'\0'), to the array
20       pointed to by dest.
21
22       The strings may not overlap.
23
24       The programmer must  ensure  that  there  is  room  for  at  least  wc‐
25       slen(src)+1 wide characters at dest.
26

RETURN VALUE

28       wcscpy() returns dest.
29

ATTRIBUTES

31       For  an  explanation  of  the  terms  used  in  this  section,  see at‐
32       tributes(7).
33
34       ┌────────────────────────────────────────────┬───────────────┬─────────┐
35       │Interface                                   │ Attribute     │ Value   │
36       ├────────────────────────────────────────────┼───────────────┼─────────┤
37       │wcscpy()                                    │ Thread safety │ MT-Safe │
38       └────────────────────────────────────────────┴───────────────┴─────────┘
39

STANDARDS

41       C11, POSIX.1-2008.
42

HISTORY

44       POSIX.1-2001, C99.
45