C 库函数 – memcpy()（手把手讲解）

C 库函数 – memcpy()

在 C 语言编程中，内存操作是开发者绕不开的核心能力之一。当我们需要将一块数据从内存的某个位置复制到另一个位置时，手动逐字节拷贝不仅低效，还容易出错。这时，C 标准库提供的 memcpy() 函数就成了我们最可靠的工具之一。

memcpy() 是 C 库函数中处理内存块复制的“标准选手”，它能高效、安全地完成从源地址到目标地址的字节级复制。无论你是初学 C 语言的新人，还是有一定经验的中级开发者，理解并掌握 memcpy() 的用法，都是提升代码质量和开发效率的关键一步。

本文将从基础用法讲起，逐步深入到常见陷阱、性能考量和实际应用场景，帮助你真正把 memcpy() 用对、用好。

函数原型与基本语法

memcpy() 的函数原型定义在头文件 string.h 中，其声明如下：

void *memcpy(void *dest, const void *src, size_t n);

这个函数的参数看起来有点“抽象”，我们来拆解一下：

• dest：目标地址，即数据要复制到的位置，类型为 void*，表示它可以指向任意类型的数据。
• src：源地址，即数据从哪里读取，同样为 void* 类型。
• n：要复制的字节数，类型为 size_t，通常用 sizeof 来获取。

返回值是 void* 类型，即指向目标内存的指针。这使得 memcpy() 可以方便地链式调用，或者用于其他内存操作。

💡 形象比喻：你可以把 memcpy() 想象成一个“快递搬运工”。他不需要知道货物是什么（整数、字符串、结构体），只要知道从 A 地（src）搬多少个箱子（n 字节），放到 B 地（dest）就行。

代码示例：基础使用

下面是一个最简单的 memcpy() 使用示例，演示如何复制一个字符数组：

#include <stdio.h>
#include <string.h>

int main() {
    // 定义源字符串
    char source[] = "Hello, World!";
    
    // 定义目标数组，必须足够大以容纳源数据
    char destination[20];

    // 使用 memcpy 复制源数据到目标
    memcpy(destination, source, sizeof(source));

    // 输出结果
    printf("复制后的字符串: %s\n", destination);

    return 0;
}

代码注释说明：

• char source[] = "Hello, World!"：定义一个字符数组，包含字符串内容，末尾自动添加 \0。
• char destination[20]：目标数组，大小为 20，确保能容纳源字符串（共 13 字节）。
• memcpy(destination, source, sizeof(source))：将 source 中的全部内容（包括结尾的 \0）复制到 destination。
• printf 输出时会自动识别字符串结束符，因此能正确显示。

运行结果：

复制后的字符串: Hello, World!

使用 memcpy() 复制结构体

memcpy() 最大的优势在于它可以复制任意类型的数据块，包括结构体。这在处理复杂数据类型时非常实用。

#include <stdio.h>
#include <string.h>

// 定义一个结构体
struct Student {
    int id;
    char name[20];
    float score;
};

int main() {
    // 创建一个学生对象
    struct Student s1 = {101, "Alice", 95.5};

    // 创建另一个结构体变量，用于接收复制的数据
    struct Student s2;

    // 使用 memcpy 复制整个结构体
    memcpy(&s2, &s1, sizeof(struct Student));

    // 输出复制后的数据
    printf("ID: %d\n", s2.id);
    printf("姓名: %s\n", s2.name);
    printf("成绩: %.1f\n", s2.score);

    return 0;
}

代码注释说明：

• &s1 和 &s2：取结构体变量的地址，因为 memcpy 需要指针参数。
• sizeof(struct Student)：获取整个结构体所占字节数，确保复制完整。
• memcpy 会将 s1 的所有成员（int、char 数组、float）按内存顺序完整复制到 s2。

✅ 关键点：memcpy() 不关心数据的“语义”，它只关心“内存布局”。只要两个结构体定义一致，复制就是安全的。

常见陷阱与注意事项

虽然 memcpy() 功能强大，但使用不当极易引发问题。以下是几个常见陷阱：

1. 目标缓冲区大小不足

char src[5] = "abc";
char dest[3];  // 只有 3 字节，但要复制 4 字节（含 \0）
memcpy(dest, src, sizeof(src));  // ❌ 严重越界！可能导致程序崩溃

错误原因：src 包含 4 个字节（a, b, c, \0），但 dest 只有 3 字节，写入会超出边界。

✅ 正确做法：确保目标缓冲区足够大。

char dest[5];  // 至少和源一样大
memcpy(dest, src, sizeof(src));

2. 重叠内存复制

如果 src 和 dest 指向的内存区域有重叠（比如 dest 在 src 之后），memcpy() 的行为是未定义的。

char data[10] = "Hello";
memcpy(data + 1, data, 5);  // ❌ 重叠！行为不可预测

✅ 解决方案：使用 memmove()，它能安全处理重叠内存。

性能与适用场景

memcpy() 的性能非常出色，因为它通常由编译器优化为使用寄存器或 SIMD 指令进行批量复制。在复制大块数据时（如图像像素、音频缓冲区、网络数据包），memcpy() 是首选。

实际应用场景举例：

• 网络编程：将接收到的数据包复制到缓冲区。
• 文件读写：将文件内容读入内存块。
• 动态内存管理：在 realloc 时复制旧数据。
• 游戏开发：快速复制角色状态、地图数据等。

⚠️ 提醒：不要用 memcpy() 替代字符串操作函数（如 strcpy）。strcpy 会自动处理 \0，而 memcpy 不会，必须手动控制长度。

与其他内存函数的对比

📌 建议：如果不确定是否重叠，优先使用 memmove()；如果是字符串，优先使用 strcpy 或 strncpy。

总结与建议

C 库函数 – memcpy() 是 C 语言中不可或缺的内存操作工具。它高效、灵活，适用于复制任意类型的数据块。然而，使用时必须格外注意目标缓冲区大小、内存重叠和数据边界问题。

对于初学者，建议先从复制字符数组和结构体开始，逐步掌握其用法。中级开发者则应关注其性能优势和潜在陷阱，避免在生产代码中引入内存错误。

记住：memcpy() 是“搬运工”，不是“搬运工+检查员”。它只负责搬，不负责检查目的地是否够大、是否重叠。因此，程序员的责任是确保调用安全。

在日常开发中，只要遵循“目标足够大、不重叠、长度准确”这三条原则，memcpy() 就能成为你手中最可靠的工具之一。

✅ 最后提醒：别忘了包含头文件 #include <string.h>，否则编译会报错。

掌握 memcpy()，就是掌握 C 语言底层内存操作的钥匙。愿你在编程路上，越走越稳，越写越快。