C 库函数 - memmove()

C 标准库 - string.h

memmove() 是 C 语言标准库 <string.h> 中的内存操作函数，用于将指定数量的字节从源地址复制到目标地址，并能安全处理内存重叠的情形。

单词释义：memmove 是 memory move（内存移动）的缩写，表示在内存中移动数据。

C 库函数 void *memmove(void *str1, const void *str2, size_t n) 从 str2 复制 n 个字节到 str1。

与 memcpy() 的区别：

• 当目标区域与源区域存在内存重叠时，memmove() 能保证在源数据被覆盖之前，先将重叠部分的字节安全地转移到目标区域，因此比 memcpy() 更可靠。
• 若目标区域与源区域完全不重叠，memmove() 的行为与 memcpy() 相同。
• 不确定两块内存是否重叠时，应优先使用 memmove()。

函数声明

void *memmove(void *str1, const void *str2, size_t n)

参数说明

• str1：目标地址，指向用于存储复制内容的内存区域（类型强制转换为 void*）。
• str2：源地址，指向待复制数据的起始位置（类型强制转换为 const void*）。
• n：要复制的字节数（size_t 类型）。

返回值

返回指向目标存储区 str1 的指针（与传入的 str1 相同）。

头文件

#include <string.h>

实例

示例 1：基础用法

下面的实例演示了 memmove() 在非重叠与重叠两种场景下的用法：

运行结果：

非重叠拷贝前：dest = oldstring, src = newstring
非重叠拷贝后：dest = newstring, src = newstring

重叠拷贝前：123456789
重叠拷贝后：121234569

代码解析：

1. 场景 1 中，dest 和 src 是两个独立数组，不存在重叠，memmove(dest, src, 9) 将 src 的前 9 个字节原样复制到 dest。
2. 场景 2 中，str + 2（目标）与 str（源）指向同一数组内的重叠区域，memmove 会先保存被覆盖的数据，再完成复制，结果正确。
3. 若将场景 2 换成 memcpy，在部分编译器或平台上可能产生错误结果，因为 memcpy 不保证处理重叠情形。

示例 2：处理重叠内存

当两块内存区域发生重叠时，memmove() 仍能给出正确结果：

运行结果：

Before: memmove can be very useful
After:  memmove can be very useful

代码解析：

• 原始字符串中，位置 5 起是 "ve can be very useful"，位置 11 起的 7 个字节是 "can be"（含末尾空格）。
• memmove(str + 5, str + 11, 7) 将 "can be" 移到位置 5，两块区域有重叠，但 memmove 会根据地址大小选择正向或逆向复制策略，确保数据完整。
• 复制后，位置 5 起的内容变为 "can be"，其余字符保持不变。

示例 3：对比 memcpy() 和 memmove()

下例展示了在相同的重叠场景下，两个函数可能产生不同结果：

运行结果：

Original: abcdefghij
memcpy:   ababababij
memmove:  ababcdfghij

说明：在此示例中，memcpy 由于逐字节正向复制，导致源数据被提前覆盖，输出与预期不符；而 memmove 检测到重叠并采用逆向复制，结果正确。不同平台或编译器的 memcpy 实现行为可能不一致，因此遇到重叠场景应始终使用 memmove。

示例 4：复制指定字节数

memmove() 是字节级操作，不会自动写入字符串终止符，使用时需手动补充 '\0'：

运行结果：

Source: Hello, World!
Dest:   Hello
Length: 5

代码解析：

• memmove(dest, src, 5) 只复制前 5 个字节（'H' 'e' 'l' 'l' 'o'）。
• memmove() 不会在目标末尾自动写入 '\0'，若省略 dest[5] = '\0'，后续的字符串操作（如 printf、strlen）将读取不确定的内存，产生未定义行为。

与 memcpy() 的区别

C 标准库 - string.h