std::memcpy

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (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	-	count

戻り値

適切な生成済みオブジェクトがある場合は、それへのポインタを返します。それ以外の場合は dest を返します。

注記

std::memcpy は、メモリからメモリへのコピーにおいて最も高速なライブラリルーチンであることを目的としています。通常、コピーするデータをスキャンする必要がある std::strcpy や、重なり合った入力を処理するための予防措置を講じる必要がある std::memmove よりも効率的です。

多くのC++コンパイラは、適切なメモリコピーループを std::memcpy の呼び出しに変換します。

厳密なエイリアシングが、2つの異なる型の値として同じメモリを検査することを禁止している場合、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	オーバーラップしていない2つの配列間で、指定された数のワイド文字をコピーする (関数)
copy	文字をコピーする (std::basic_string<CharT,Traits,Allocator> の public メンバ関数)
copycopy_if (C++11)	要素の範囲を新しい場所にコピーする (関数テンプレート)
copy_backward	要素の範囲を逆順にコピーする (関数テンプレート)
is_trivially_copyable (C++11)	型がトリビアルにコピー可能であるかをチェックする (クラステンプレート)
C言語ドキュメント（memcpy）