std::memmove

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

正则表达式库 (C++11)

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

原生数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码标识

text_encoding (C++26)

 

空终止字节字符串

函数
字符分类
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
字符操作
tolower	toupper
转换为数字格式
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
字符串操作
strcpy strncpy strxfrm	strcat strncat
字符串检查
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
字符数组函数
memchr memcmp memset	memcpy memmove
杂项
strerror

 

在头文件 <cstring> 中定义
void* memmove( void* dest, const void* src, std::size_t count );

按顺序执行以下操作

1. 隐式地在 dest 创建对象。
2. 将 count 个字符（如同 unsigned char 类型，下同）从 src 所指向的对象复制到一个临时数组 arr 中，该数组有 count 个字符，其中 arr 不与 dest 和 src 所指向的对象重叠。
3. 将 count 个字符从 arr 复制到 dest 所指向的对象中。

若 dest 或 src 为 空指针或非法指针，则行为未定义。

参数

dest	-	指向要复制到的内存位置的指针
src	-	指向要复制来源的内存位置的指针
count	-	要复制的字节数

返回值

若存在合适的已创建对象，则返回指向它的指针；否则返回 dest。

注意

尽管规范声称使用临时缓冲区，但此函数的实际实现不会带来双重复制或额外内存的开销。对于较小的 count，它可能会加载并写入寄存器；对于较大的块，常见方法（glibc 和 bsd libc）是，如果目标在源之前开始，则从缓冲区开头向前复制字节，否则从末尾向后复制，在完全没有重叠时回退到 std::memcpy。

在严格别名禁止将同一内存作为两种不同类型的值进行检查时，`std::memmove` 可用于转换值。

示例

运行此代码

#include <cstring>
#include <iostream>
 
int main()
{
    char str[] = "1234567890";
    std::cout << str << '\n';
    std::memmove(str + 4, str + 3, 3); // copies from [4, 5, 6] to [5, 6, 7]
    std::cout << str << '\n';
}

输出

1234567890
1234456890

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	发布时的行为	正确的行为
LWG 4064	C++98	尚不清楚返回的指针是否指向合适的已创建对象	已明确

参阅

memcpy	将一个缓冲区复制到另一个缓冲区 (函数)
memset	用字符填充缓冲区 (函数)
wmemmove	在两个可能重叠的数组之间复制一定数量的宽字符 (函数)
copycopy_if (C++11)	将一个范围的元素复制到一个新位置 (函数模板)
copy_backward	以逆序复制一个范围的元素 (函数模板)
is_trivially_copyable (C++11)	检查类型是否为可平凡复制类型 (类模板)
C 文档 for memmove