#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}，因为会这样复制：

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

编译器可能会在 memcpy 进行重叠复制时纠正该问题，导致上述错误无法复现。

#推荐阅读

• C 语言标准库函数 memmove
• C 语言标准库函数 strcpy
• C 语言标准库函数 strncpy
• memcpy - cppreference

#参考标准

• 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