Namespaces
Variants

wmemcpy, wmemcpy_s

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
定义于头文件 <wchar.h>
(1)
wchar_t * wmemcpy ( wchar_t * dest, const wchar_t * src, size_t count ) ;
(C95 起)
(C99 前)
wchar_t * wmemcpy ( wchar_t * restrict dest, const wchar_t * restrict src,
size_t count ) ;
(C99 起)
errno_t wmemcpy_s ( wchar_t * restrict dest, rsize_t destsz,
const wchar_t * restrict src, rsize_t count ) ;
(2) (C11 起)
1) 从 src 所指向的宽字符数组中精确复制 count 个连续宽字符到 dest 所指向的宽字符数组。若对象存在重叠，则行为未定义。若 count 为零，该函数不执行任何操作。
2) 与 (1) 相同，区别在于以下错误会在运行时被检测到并调用当前安装的 约束处理函数 ：
  • src 或 dest 是空指针
  • destsz 或 count 大于 RSIZE_MAX / sizeof ( wchar_t )
  • count 大于 destsz （将发生溢出）
  • 源数组和目标数组之间会出现重叠
与所有边界检查函数一样，仅当实现定义了 __STDC_LIB_EXT1__ 且用户在包含 <wchar.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整型常量 1 时，才保证 wmemcpy_s 可用。

目录

参数

dest - 指向目标宽字符数组的指针
src - 指向源宽字符数组的指针
count - 要复制的宽字符数量
destsz - 最大写入宽字符数（目标缓冲区的大小）

返回值

1) 返回 dest 的副本
2) 成功时返回零，错误时返回非零值。此外，在发生错误时，将整个 dst 缓冲区（直至但不包括 dst + dstsz 位置）填充为空宽字符 L ' \0 ' （除非 dest 为空指针或 destsz 大于 RSIZE_MAX / sizeof ( wchar_t ) ）

注释

该函数的字节字符串对应版本是 strncpy ，而非 strcpy 。

此函数对区域设置不敏感，且不关注所复制的 wchar_t 对象值：空字符及无效字符均会被复制。

示例

运行此代码 
#include <stdio.h>
#include <wchar.h>
#include <locale.h>
int main(void)
{
    wchar_t from1[] = L"नमस्ते";
    size_t sz1 = sizeof from1 / sizeof *from1;
    wchar_t from2[] = L"Բարև";
    size_t sz2 = sizeof from2 / sizeof *from2;
    wchar_t to[sz1 + sz2];
    wmemcpy(to, from1, sz1); // 复制 from1，包括其空终止符
    wmemcpy(to + sz1, from2, sz2); // 追加 from2，包括其空终止符
    setlocale(LC_ALL, "en_US.utf8");
    printf("Wide array contains: ");
    for(size_t n = 0; n < sizeof to / sizeof *to; ++n)
        if(to[n])
            printf("%lc", to[n]);
        else
            printf("\\0");
    printf("\n");
}

可能的输出： 

Wide array contains: नमस्ते\0Բարև\0

参考文献

  • C11 标准 (ISO/IEC 9899:2011):
  • 7.29.4.2.3 wmemcpy 函数 (页: 431)
  • K.3.9.2.1.3 wmemcpy_s 函数 (页: 641)
  • C99 标准 (ISO/IEC 9899:1999):
  • 7.24.4.2.3 wmemcpy 函数 (页: 377)

参考

(C95) (C11)
在两个可能重叠的数组间复制指定数量的宽字符
(函数)
(C11)
将一个字符串的指定数量字符复制到另一个字符串
(函数)
C++ 文档 for wmemcpy