std::memmove

 

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* memmove( void* dest, const void* src, std::size_t count );

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

这些对象可以重叠：复制操作就像将字符复制到一个临时字符数组，然后将字符从数组复制到 dest 一样。

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

如果这些对象 可能重叠或不是 TriviallyCopyable，memmove 的行为未指定，并且 可能未定义。

参数

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

返回值

dest

备注

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

尽管指定为“就像”使用临时缓冲区一样，但该函数的实际实现不会产生双重复制或额外内存的开销。对于较小的 count，它可能会加载和写入寄存器；对于较大的块，一种常见的方法（glibc 和 bsd libc）是如果目标从源开始，则从缓冲区开头向前复制字节，否则从末尾向后复制，当没有重叠时，返回到 std::memcpy。

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

示例

运行这段代码

#include <cstring>
#include <iostream>
 
int main()
{
    char str[] = "1234567890";
    std::cout << str << '\n';
    std::memmove(str + 4, str + 3, 3); // copies from [4, 5, 6] to [5, 6, 7]
    std::cout << str << '\n';
}

输出

1234567890
1234456890

参见

memcpy	将一个缓冲区复制到另一个缓冲区 (函数)
memset	用一个字符填充缓冲区 (函数)
wmemmove	在两个可能重叠的数组之间复制一定数量的宽字符 (函数)
copycopy_if (C++11)	将一个范围内的元素复制到新位置 (函数模板)
copy_backward	按反向顺序复制一个范围内的元素 (函数模板)
is_trivially_copyable (C++11)	检查一个类型是否可以平凡地复制 (类模板)
C 文档 for memmove