wmemmove，wmemmove_s

定义在头文件 `<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（会发生溢出）

与所有边界检查函数一样，wmemcpy_s 只有在 __STDC_LIB_EXT1__ 被实现定义，并且用户在包含 <wchar.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整型常量 1 时才能保证可用。

[编辑] 参数

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

[编辑] 返回值

1) 返回 dest 的副本

2) 成功返回零，错误返回非零。此外，如果出错，则用空宽字符（L'\0'）填充整个 dst 直到但不包括 dst+dstsz（除非 dest 为空或 destsz 大于 RSIZE_MAX/sizeof(wchar_t)）。

[编辑] 注释

此函数不区分区域设置，并且不关注其复制的 wchar_t 对象的值：空字符和无效字符也会被复制。

[编辑] 示例

运行此代码

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
 
    wchar_t str[] = L"αβγδεζηθικλμνξοπρστυφχψω";
    printf("%ls\n", str);
    wmemmove(str + 4, str + 3, 3); // copy from [δεζ] to [εζη]
    printf("%ls\n", str);
}

输出

αβγδεζηθικλμνξοπρστυφχψω
αβγδδεζθικλμνξοπρστυφχψω

[编辑] 参考文献

C23 标准 (ISO/IEC 9899:2024)

7.29.4.2.4 wmemmove 函数 (p: TBD)

K.3.9.2.1.4 wmemmove_s 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.29.4.2.4 wmemmove 函数 (p: TBD)

K.3.9.2.1.4 wmemmove_s 函数 (p: TBD)

C11 标准 (ISO/IEC 9899:2011)

7.29.4.2.4 wmemmove 函数 (p: 432)

K.3.9.2.1.4 wmemmove_s 函数 (p: 642)

C99 标准 (ISO/IEC 9899:1999)

7.24.4.2.4 wmemmove 函数 (p: 378)

[编辑] 另请参阅

memmovememmove_s (C11)	将一个缓冲区移动到另一个缓冲区 (函数) [编辑]
wmemcpywmemcpy_s (C95)(C11)	在两个非重叠数组之间复制一定数量的宽字符 (函数) [编辑]
C++ 文档用于 wmemmove

编译器支持
语言
头文件
类型支持
程序实用程序
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用程序
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.com

命名空间

变体

视图

操作