std::memcpy

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

正则表达式库 (C++11)

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

原始数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码标识

text_encoding (C++26)

 

空终止字节字符串

函数
字符分类
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
字符操作
tolower	toupper
转换为数值格式
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
字符串操作
strcpy strncpy strxfrm	strcat strncat
字符串检查
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
字符数组函数
memchr memcmp memset	memcpy memmove
杂项
strerror

 

定义于头文件 <cstring>
void* memcpy( void* dest, const void* src, std::size_t count );

按顺序执行以下操作

1. 隐式创建在 dest 的对象。
2. 从 src 指向的对象复制 count 个字符（如同类型为 unsigned char），到 dest 指向的对象。

如果满足以下任何条件，则行为未定义

• dest 或 src 是 空指针 或 无效指针。
• 复制发生在重叠的对象之间。

参数

dest	-	指向要复制到的内存位置的指针
src	-	指向要从中复制的内存位置的指针
count	-	要复制的字节数

返回值

如果存在合适的已创建对象，则返回指向它的指针；否则返回 dest。

注意

std::memcpy 旨在成为最快的内存到内存复制库例程。它通常比 std::strcpy 更有效，后者必须扫描它复制的数据，或者比 std::memmove 更有效，后者必须采取预防措施来处理重叠的输入。

一些 C++ 编译器将合适的内存复制循环转换为 std::memcpy 调用。

在 严格别名 禁止将同一内存作为两种不同类型的值进行检查的情况下，可以使用 std::memcpy 来转换值。

示例

运行此代码

#include <cstdint>
#include <cstring>
#include <iostream>
 
int main()
{
    // simple usage
    char source[] = "once upon a daydream...", dest[4];
    std::memcpy(dest, source, sizeof dest);
    std::cout << "dest[4] = {";
    for (int n{}; char c : dest)
        std::cout << (n++ ? ", " : "") << '\'' << c << "'";
    std::cout << "};\n";
 
    // reinterpreting
    double d = 0.1;
//  std::int64_t n = *reinterpret_cast<std::int64_t*>(&d); // aliasing violation
    std::int64_t n;
    std::memcpy(&n, &d, sizeof d); // OK
 
    std::cout << std::hexfloat << d << " is " << std::hex << n
              << " as a std::int64_t\n" << std::dec;
 
    // object creation in destination buffer
    struct S
    {
        int x{42};
        void print() const { std::cout << '{' << x << "}\n"; }
    } s;
    alignas(S) char buf[sizeof(S)];
    S* ps = new (buf) S; // placement new
    std::memcpy(ps, &s, sizeof s);
    ps->print();
}

输出

dest[4] = {'o', 'n', 'c', 'e'};
0x1.999999999999ap-4 is 3fb999999999999a as a std::int64_t
{42}

缺陷报告

以下行为变更缺陷报告被追溯应用于以前发布的 C++ 标准。

DR	应用于	已发布行为	正确行为
LWG 4064	C++98	不清楚返回的指针是否指向合适的已创建对象	明确了

参见

memmove	将一个缓冲区移动到另一个缓冲区 (函数)
memset	用字符填充缓冲区 (函数)
wmemcpy	在两个非重叠数组之间复制一定数量的宽字符 (函数)
copy	复制字符 (std::basic_string<CharT,Traits,Allocator> 的公共成员函数)
copycopy_if (C++11)	将一系列元素复制到新位置 (函数模板)
copy_backward	以相反的顺序复制一系列元素 (函数模板)
is_trivially_copyable (C++11)	检查类型是否为可平凡复制的 (类模板)
C 文档 关于 memcpy