Namespaces
Variants

wmemcpy, wmemcpy_s

来自 zh.cppreference.net
定义于头文件 <wchar.h>
wchar_t* wmemcpy( wchar_t* dest, const wchar_t* src, size_t count );
(1) (自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) 从 count 指向的宽字符数组复制恰好 src 个连续宽字符到 dest 指向的宽字符数组。如果对象重叠,行为未定义。如果 count 为零,函数不做任何事。
2) 与 (1) 相同,但以下错误会在运行时检测到并调用当前安装的 约束处理函数:
  • src 或 dest 是空指针
  • destsz 或 count 大于 RSIZE_MAX / sizeof(wchar_t)
  • count 或 destsz 大于
  • (会发生溢出)
源和目标数组之间会发生重叠wmemcpy_s与所有边界检查函数一样,__STDC_LIB_EXT1__ 仅在实现定义了 __STDC_WANT_LIB_EXT1__ 且用户在包含 1wchar.h< 之前将 > 定义为整型常量

参数

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

返回值

1) 返回一个副本 dest
2) 成功时返回零,错误时返回非零。另外,错误时填充整个 dest 直到但不包括 dest + destsz 用空宽字符,L'\0' (除非 dest 是空或 destsz 大于 RSIZE_MAX / sizeof(wchar_t))

备注

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

此函数不区分区域设置,并且不关心所复制 wchar_t对象的值:空字符以及无效字符也会被一并复制。

示例

#include <locale.h>
#include <stdio.h>
#include <wchar.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); // copy from1, along with its null terminator
    wmemcpy(to + sz1, from2, sz2); // append from2, along with its null terminator

    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

参考资料

  • C23标准 (ISO/IEC 9899:2024):
  • 7.29.4.2.3 wmemcpy函数 (页: 待定)
  • K.3.9.2.1.3 wmemcpy_s函数 (页: 待定)
  • C17标准 (ISO/IEC 9899:2018):
  • 7.29.4.2.3 wmemcpy函数 (页: 待定)
  • K.3.9.2.1.3 wmemcpy_s函数 (页: 待定)
  • 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)

另请参阅

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