www.LinuxHowtos.org

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.