std::memcpy

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

字符串库

以空字符结尾的字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

以空字符结尾的字节字符串

函数
字符操作
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 );

将 count 字节从 src 指向的对象复制到 dest 指向的对象。这两个对象都被重新解释为 unsigned char 数组。

如果对象重叠，则行为未定义。

如果 dest 或 src 是 无效或空指针，则行为未定义，即使 count 为零。

如果对象是 潜在重叠的 或不是 TriviallyCopyable，则 memcpy 的行为未定义，并且可能 未定义。

参数

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

返回值

dest

备注

std::memcpy 可用于 隐式创建 目标缓冲区中的对象。

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}

另请参阅

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