wmemcpy_s(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

wmemcpy_s(3c)

wmemcpy(3C)              Standard C Library Functions              wmemcpy(3C)

NAME
       wmemcpy, wmemcpy_s - copy wide-characters in memory

SYNOPSIS
       #include <wchar.h>

       wchar_t *wmemcpy(wchar_t *ws1, const wchar_t *ws2, size_t n);


       #define __STDC_WANT_LIB_EXT1__ 1
       #include <wchar.h>

       errno_t wmemcpy_s(wchar_t *restrict ws1, rsize_t ws1max,
           const wchar_t *restrict ws2, rsize_t n);

DESCRIPTION
       The wmemcpy() function copies n wide-characters from the object pointed
       to  by  ws2  to  the object pointed to be ws1. This function is not af‐
       fected by locale and all wchar_t values are  treated  identically.  The
       null wide-character and wchar_t values not corresponding to valid char‐
       acters are not treated specially.


       If n is zero, ws1 and ws2 must both be valid pointers, and the function
       copies zero wide-characters.


       The  wmemcpy_s() function is part of the C11 bounds checking interfaces
       specified in the C11 standard, Annex K. It provides similar functional‐
       ity to the wmemcpy() function, except for additional checks on the  pa‐
       rameters  passed and explicit runtime constraints as defined in the C11
       standard.   See   runtime_constraint_handler(3C)   and   INCITS/ISO/IEC
       9899:2011.

RETURN VALUES
       The wmemcpy() function returns the value of ws1.


       If  no  runtime constraint violation is detected, the wmemcpy_s() func‐
       tion returns 0, otherwise, it returns a non-zero value.

ERRORS
       No errors are defined.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE  _  Interface  StabilityCommitted  _ MT-LevelSee below _
       StandardSee below


   MT-Level
       The wmemcpy() function is Async-Signal-Safe.


       The wmemcpy_s() function cannot be used safely in a  multithreaded  ap‐
       plication  due to the runtime constraint handler. For more information,
       see the runtime_constraint_handler(3C) man page.

   Standard
       See standards(7) for descriptions of the following standards:

       tab() box; cw(2.44i) |cw(3.06i) lw(2.44i) |lw(3.06i) INTERFACESAPPLICA‐
       BLE STANDARDS _ wmemcpy()T{
         C95 through C11,
         POSIX.1-2001 through 2008,
         SUS through SUSv4,
         XPG4 through XPG7

       T} _ MT-LevelAsync-Signal-Safe _ StandardSee standards(7).


SEE ALSO
       runtime_constraint_handler(3C), wmemchr(3C), wmemcmp(3C), wmemmove(3C),
       wmemset(3C), attributes(7), standards(7)


       Handling Characters and Character Strings in Internationalizing and Lo‐
       calizing Applications in Oracle Solaris

HISTORY
       The wmemcpy_s() function was added to Solaris  in  the  Oracle  Solaris
       11.4.0 release.


       The wmemcpy() function was added to Solaris in the Solaris 7 release.

Oracle Solaris 11.4               25 Nov 2024                      wmemcpy(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3