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) 返回一个副本
dest2) 成功时返回零,错误时返回非零。另外,错误时填充整个
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)
另请参阅
(C95)(C11) |
在两个可能重叠的宽字符数组之间复制指定数量的宽字符 (函数) |
(C11) |
将指定数量的字符从一个字符串复制到另一个字符串 (函数) |
C++ 文档 关于 wmemcpy
| |