国际访客建议访问 Primers 编程伙伴 国际版站点 > C 教程 > memcpy 以获得更好的体验。

# C 语言标准库函数 memcpy

在头文件 string.h 中定义。
/*********************************************
 * @brief 复制内存数据
 * @param dest 目标内存地址
 * @param src 源内存地址
 * @param count 要复制的字节数
 * @return 目标地址
 ********************************************/
void* memcpy(void* restrict dest, const void* restrict src, size_t count);

!subtitle:说明

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

注意:

  • dest 必须有足够的空间

  • destsrc 指向的内存块不可以存在重叠

!subtitle:参数

  • dest - 目标内存地址

  • src - 源内存地址

  • count - 要复制的字节数

!subtitle:返回值

  • 返回目标地址 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 进行内存复制时,destsrc 指向的内存不能重叠,否则可能产生错误。例如:

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},因为会这样复制:

flowchart TD
    subgraph A["开始"]
        1 ~~~ 2 ~~~ 3 ~~~ 4 ~~~ 5
    end

    subgraph B["array[0] 复制到 array[1]"]
        B1[1] ~~~ B2[1] ~~~ B3[3] ~~~ B4[4] ~~~ B5[5]
        B1 --> B2
    end

    subgraph C["array[1] 复制到 array[2]"]
        C1[1] ~~~ C2[1] ~~~ C3[1] ~~~ C4[4] ~~~ C5[5]
        C2 --> C3
    end

    subgraph D["array[2] 复制到 array[3]"]
        D1[1] ~~~ D2[1] ~~~ D3[1] ~~~ D4[1] ~~~ D5[5]
        D3 --> D4
    end

    subgraph E["array[3] 复制到 array[4]"]
        E1[1] ~~~ E2[1] ~~~ E3[1] ~~~ E4[1] ~~~ E5[1]
        E4 --> E5
    end

    A --> B --> C --> D --> E

    classDef SUB fill:#212121,color:#fefefe,stroke:#e91e63
    class A SUB
    class B SUB
    class C SUB
    class D SUB
    class E SUB

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

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

# 推荐阅读

# 参考标准

  • 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-27 09:38:09 创建于: 2025-11-27 09:38:09