home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | CONFORMING TO | SEE ALSO | COLOPHONThe Linux Programming Interface


WCPCPY(3)                     Linux Programmer's Manual                     WCPCPY(3)

NAME         top

       wcpcpy - copy a wide-character string, returning a pointer to its end

SYNOPSIS         top

       #include <wchar.h>

       wchar_t *wcpcpy(wchar_t *dest, const wchar_t *src);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       wcpcpy():
           Since glibc 2.10:
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Before glibc 2.10:
               _GNU_SOURCE

DESCRIPTION         top

       The wcpcpy() function is the wide-character equivalent of the stpcpy(3)
       function.  It copies the wide-character string pointed to by src, including
       the terminating L'\0' character, 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.

RETURN VALUE         top

       wcpcpy() returns a pointer to the end of the wide-character string dest, that
       is, a pointer to the terminating L'\0' character.

CONFORMING TO         top

       This function is a GNU extension.

SEE ALSO         top

       strcpy(3), wcscpy(3)

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

GNU                                   2010-09-15                            WCPCPY(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable
counter