当前位置： C语言 -- 附录 -- wmemcpy_s

wmemcpy_s函数

概要： 
#define __STDC_WANT_LIB_EXT1__ 1
#include <wchar.h>
errno_t wmemcpy_s(wchar_t * restrict s1, 
      rsize_t s1max,
      const wchar_t * restrict s2, 
      rsize_t n);
描述：

该函数从参数s2指向的对象复制n个连续宽字符到参数s1指向的对象。

运行约束：

参数s1和参数s2不能是空指针。参数s1max和参数n应不大于RSIZE_MAX/sizeof(wchar_t)。参数n应不大于s1max。复制不能发生在重叠对象之间。

在存在运行约束冲突的情况下，如果参数s1不是空指针并且参数s1max不大于RSIZE_MAX/sizeof(wchar_t)，函数向参数s1指向对象的前s1max个宽字符存储0。

参数：
wchar_t * restrict s1

指向目标对象的指针，复制的内容将存入该对象。

rsize_t s1max

目标对象中修改的最大宽字符数。

const wchar_t * restrict s2

指向源对象的指针，将从该对象复制内容。

rsize_t n

复制的宽字符数。

返回值：

如果不存在运行约束冲突，函数返回0；否则函数返回非0值。

范例： 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
/*安全函数wmemcpy_s范例*/

#define __STDC_WANT_LIB_EXT1__ 1
#include <locale.h>
#include <wchar.h>

#define LENGTH 100

int main(void)
{
    setlocale(LC_ALL, "");
    
    const wchar_t source[] = L"读书破万卷，下笔如有神。";
    wchar_t destination[LENGTH];
    rsize_t n = sizeof(source)/sizeof(wchar_t);

    if(!(wmemcpy_s(destination, LENGTH, source, n)))
    {
        wprintf_s(L"%ls\n", destination);
    }
    
    return 0;
}
输出：

读书破万卷，下笔如有神。

注：使用Visual Studio编译。

相关内容：
wmemmove_s 移动内存区域宽字符序列的安全函数。
wcscpy_s 复制宽字符串的安全函数。
wcsncpy_s 从宽字符串中复制限定数量宽字符的安全函数。