std::memmove

ヘッダー `<cstring>` で定義
void* memmove( void* dest, const void* src, std::size_t count );

以下の操作を順番に実行します

暗黙的にオブジェクトを生成します dest に。
src が指すオブジェクトから、count バイトを、count バイトの一時配列 arr にコピーします。arr は dest が指すオブジェクトと src が指すオブジェクトと重複しません。count バイトは unsigned char 型として扱われます（以下同様）。
arr から count バイトを dest が指すオブジェクトにコピーします。

dest または src がヌルポインタまたは無効なポインタの場合、振る舞いは未定義です。

仕様では一時バッファが使用されるとされていますが、この関数の実際の С++ 実装は二重コピーや追加メモリのオーバーヘッドを発生させません。小さな 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++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 4064	C++98	返されるポインタが適切な生成されたオブジェクトを指すかどうか不明確でした。	明確化された

[編集] 関連項目

memcpy	あるバッファを別のバッファにコピーする (関数) [編集]
memset	バッファを文字で埋める (関数) [編集]
wmemmove	オーバーラップしている可能性のある2つの配列間で、指定された数のワイド文字をコピーする (関数) [編集]
copycopy_if (C++11)	要素の範囲を新しい場所にコピーする (関数テンプレート) [編集]
copy_backward	要素の範囲を逆順にコピーする (関数テンプレート) [編集]
is_trivially_copyable (C++11)	型がトリビアルにコピー可能であるかをチェックする (クラステンプレート) [編集]
C言語のドキュメント memmove

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作

std::memmove

目次

[編集] パラメータ

[編集] 戻り値

[編集] 注記

[編集] 例

[編集] 不具合報告

[編集] 関連項目

ナビゲーション

ツールボックス

dest	-	コピー先のメモリ位置へのポインタ
src	-	コピー元のメモリ位置へのポインタ
count	-	count