std::memmove

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

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

按順序執行以下操作

1. 隱式地在 dest 建立物件。
2. 將 count 個字元（如同 unsigned char 型別，下同）從 src 所指向的物件複製到一個臨時陣列 arr 中，該陣列有 count 個字元，其中 arr 不與 dest 和 src 所指向的物件重疊。
3. 將 count 個字元從 arr 複製到 dest 所指向的物件中。

若 dest 或 src 為 空指標或非法指標，則行為未定義。

引數

dest	-	指向要複製到的記憶體位置的指標
src	-	指向要複製來源的記憶體位置的指標
count	-	要複製的位元組數

返回值

若存在合適的已建立物件，則返回指向它的指標；否則返回 dest。

注意

儘管規範聲稱使用臨時緩衝區，但此函式的實際實現不會帶來雙重複制或額外記憶體的開銷。對於較小的 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

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 4064	C++98	尚不清楚返回的指標是否指向合適的已建立物件	已明確

參閱

memcpy	將一個緩衝區複製到另一個緩衝區 (函式)
memset	用字元填充緩衝區 (函式)
wmemmove	在兩個可能重疊的陣列之間複製一定數量的寬字元 (函式)
copycopy_if (C++11)	將一個範圍的元素複製到一個新位置 (函式模板)
copy_backward	以逆序複製一個範圍的元素 (函式模板)
is_trivially_copyable (C++11)	檢查型別是否為可平凡複製型別 (類模板)
C 文件 for memmove