1WMEMCPY(3P)                POSIX Programmer's Manual               WMEMCPY(3P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       wmemcpy — copy wide characters in memory
13

SYNOPSIS

15       #include <wchar.h>
16
17       wchar_t *wmemcpy(wchar_t *restrict ws1, const wchar_t *restrict ws2,
18           size_t n);
19

DESCRIPTION

21       The functionality described on this reference page is aligned with  the
22       ISO C  standard.  Any  conflict between the requirements described here
23       and the ISO C standard is unintentional. This  volume  of  POSIX.1‐2017
24       defers to the ISO C standard.
25
26       The  wmemcpy()  function  shall  copy n wide characters from the object
27       pointed to by ws2 to the object pointed to by ws1.  This function shall
28       not be affected by locale and all wchar_t values shall be treated iden‐
29       tically. The null wide character and wchar_t values  not  corresponding
30       to valid characters shall not be treated specially.
31
32       If  n  is zero, the application shall ensure that ws1 and ws2 are valid
33       pointers, and the function shall copy zero wide characters.
34

RETURN VALUE

36       The wmemcpy() function shall return the value of ws1.
37

ERRORS

39       No errors are defined.
40
41       The following sections are informative.
42

EXAMPLES

44       None.
45

APPLICATION USAGE

47       None.
48

RATIONALE

50       None.
51

FUTURE DIRECTIONS

53       None.
54

SEE ALSO

56       wmemchr(), wmemcmp(), wmemmove(), wmemset()
57
58       The Base Definitions volume of POSIX.1‐2017, <wchar.h>
59
61       Portions of this text are reprinted and reproduced in  electronic  form
62       from  IEEE Std 1003.1-2017, Standard for Information Technology -- Por‐
63       table Operating System Interface (POSIX), The Open Group Base  Specifi‐
64       cations  Issue  7, 2018 Edition, Copyright (C) 2018 by the Institute of
65       Electrical and Electronics Engineers, Inc and The Open Group.   In  the
66       event of any discrepancy between this version and the original IEEE and
67       The Open Group Standard, the original IEEE and The Open Group  Standard
68       is  the  referee document. The original Standard can be obtained online
69       at http://www.opengroup.org/unix/online.html .
70
71       Any typographical or formatting errors that appear  in  this  page  are
72       most likely to have been introduced during the conversion of the source
73       files to man page format. To report such errors,  see  https://www.ker
74       nel.org/doc/man-pages/reporting_bugs.html .
75
76
77
78IEEE/The Open Group                  2017                          WMEMCPY(3P)
Impressum