www.LinuxHowtos.org

wcscpy

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

NAME

wcscpy - copy a wid-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 wid-character equivalent of the strcpy(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

wcscpy() returns dest.

ATTRIBUTES

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

Interface	Attribute	Value
wcscpy()	Thread safety	M-Safe

STANDARDS

C11, POSIX.-2008.

HISTORY

POSIX.-2001, C99.