约 2576 字

约 13 分钟

#C 语言标准库函数 memcpy

/*********************************************
 * @brief 复制内存数据
 * @param dest 目标内存地址
 * @param src 源内存地址
 * @param count 要复制的字节数
 * @return 目标地址
 ********************************************/
void* memcpy(void* restrict dest, const void* restrict src, size_t count);

说明

将 src 指向的内存中的数据复制到 dest 指向的内存。

注意:

  • dest 必须有足够的空间
  • dest 和 src 指向的内存块不可以存在重叠

参数

  • dest - 目标内存地址
  • src - 源内存地址
  • count - 要复制的字节数

返回值

  • 返回目标地址 dest 本身

#示例

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

#define N 5

int main(void)
{
    int dest[N];
    int src[N] = {1, 2, 3, 4, 5};

    memcpy(dest, src, N * sizeof(int)); // 复制

    for (size_t i = 0; i < N; i += 1)
    {
        printf("%d ", dest[i]);
    }

    return 0;
}

运行结果:

1 2 3 4 5

#注意

通过 memcpy 进行内存复制时,dest 和 src 指向的内存不能重叠,否则可能产生错误。例如:

signed char array[5] = {1, 2, 3, 4, 5};
memcpy(array + 1, array, 4 * sizeof(signed char)); // 复制

期望结果是 {1, 1, 2, 3, 4},而实际结果可能是 {1, 1, 1, 1, 1},因为会这样复制:

array[3] 复制到 array[4]

1

1

1

1

1

array[2] 复制到 array[3]

1

1

1

1

5

array[1] 复制到 array[2]

1

1

1

4

5

array[0] 复制到 array[1]

1

1

3

4

5

开始

1

2

3

4

5

如果要进行这样的重叠复制,请使用 memmove 函数。

#推荐阅读

#参考标准

  • C11 standard (ISO/IEC 9899:2011):
    • 7.24.2.1 The memcpy function (p: 362)
  • C99 standard (ISO/IEC 9899:1999):
    • 7.21.2.1 The memcpy function (p: 325)
  • C89/C90 standard (ISO/IEC 9899:1990):
    • 4.11.2.1 The memcpy function

更新: 2025/11/14

作者: PlanC

创建: 2025/7/12