wmemmove, wmemmove_s
来自 cppreference.cn
定义于头文件 <wchar.h> |
||
wchar_t* wmemmove( wchar_t* dest, const wchar_t* src, size_t count ); |
(1) | (始于 C95) |
errno_t wmemmove_s( wchar_t *dest, rsize_t destsz, const wchar_t *src, rsize_t count); |
(2) | (始于 C11) |
1) 从 src 指向的宽字符数组精确复制 count 个连续的宽字符到 dest 指向的宽字符数组。如果 count 为零,函数不执行任何操作。数组可能重叠:复制的发生如同宽字符被复制到一个临时的宽字符数组,然后再从临时数组复制到 dest。
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 | - | 指向要从中复制的宽字符数组的指针 |
destsz | - | 要写入的最大宽字符数(目标缓冲区的大小) |
count | - | 要复制的宽字符数 |
[编辑] 返回值
1) 返回 dest 的副本
2) 成功时返回零,错误时返回非零值。此外,在错误时,用空宽字符 L'\0' 填充整个 dst 直到但不包括 dst+dstsz (除非 dest 为空或 destsz 大于 RSIZE_MAX/sizeof(wchar_t))
[编辑] 注解
此函数不区分区域设置,并且不关注它复制的 wchar_t 对象的值:空字符以及无效字符也会被复制。
[编辑] 示例
运行此代码
输出
αβγδεζηθικλμνξοπρστυφχψω αβγδδεζθικλμνξοπρστυφχψω
[编辑] 参考
- C23 标准 (ISO/IEC 9899:2024)
- 7.29.4.2.4 wmemmove 函数 (页码: 待定)
- K.3.9.2.1.4 wmemmove_s 函数 (页码: 待定)
- C17 标准 (ISO/IEC 9899:2018)
- 7.29.4.2.4 wmemmove 函数 (页码: 待定)
- K.3.9.2.1.4 wmemmove_s 函数 (页码: 待定)
- C11 标准 (ISO/IEC 9899:2011)
- 7.29.4.2.4 wmemmove 函数 (页码: 432)
- K.3.9.2.1.4 wmemmove_s 函数 (页码: 642)
- C99 标准 (ISO/IEC 9899:1999)
- 7.24.4.2.4 wmemmove 函数 (页码: 378)
[编辑] 参见
(C11) |
将一个缓冲区移动到另一个缓冲区 (函数) |
(C95)(C11) |
在两个非重叠数组之间复制一定数量的宽字符 (函数) |
C++ 文档 关于 wmemmove
|