dwww Home | Manual pages | Find package

wcscpy(3)                  Library Functions Manual                  wcscpy(3)

NAME
       wcscpy - copy a wide-character string

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <wchar.h>

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

DESCRIPTION
       The wcscpy() function is the wide-character equivalent of the strcpy(3)
       function.   It  copies the wide-character string pointed to by src, in-
       cluding 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 wc-
       slen(src)+1 wide characters at dest.

RETURN VALUE
       wcscpy() returns dest.

ATTRIBUTES
       For an explanation of the terms  used  in  this  section,  see  attrib-
       utes(7).
       ┌───────────────────────────────────────────┬───────────────┬─────────┐
       │ Interface                                 Attribute     Value   │
       ├───────────────────────────────────────────┼───────────────┼─────────┤
       │ wcscpy()                                  │ Thread safety │ MT-Safe │
       └───────────────────────────────────────────┴───────────────┴─────────┘

STANDARDS
       C11, POSIX.1-2008.

HISTORY
       POSIX.1-2001, C99.

SEE ALSO
       strcpy(3), wcpcpy(3), wcscat(3), wcsdup(3), wmemcpy(3)

Linux man-pages 6.7               2023-10-31                         wcscpy(3)

Generated by dwww version 1.16 on Tue Dec 16 11:06:52 CET 2025.