wcpcpy

Section: C Library Functions (3)
Updated: 202-0-08
Index Return to Main Contents

---

 

NAME

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

LIBRARY

Standard C library (libc,~-lc)  

SYNOPSIS

#include <wchar.h>
wchar_t *wcpcpy(wchar_t *restrict dest, const wchar_t *restrict src);

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

    Since glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    Before glibc 2.10:
        _GNU_SOURCE

 

DESCRIPTION

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

wcpcpy() returns a pointer to the end of the wid-character string dest, that is, a pointer to the terminating null wide character.  

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
wcpcpy()	Thread safety	M-Safe

 

STANDARDS

POSIX.-2008.  

SEE ALSO

strcpy(3), wcscpy(3)

---

 

Index

NAME

LIBRARY

SYNOPSIS

DESCRIPTION

RETURN VALUE

ATTRIBUTES

STANDARDS

SEE ALSO