std:: memcpy
|
定義済みヘッダー
<cstring>
|
||
|
void
*
memcpy
(
void
*
dest,
const
void
*
src,
std::
size_t
count
)
;
|
||
以下の操作を順番に実行します：
- 暗黙的にオブジェクトを作成 します（ dest に）。
- src が指すオブジェクトから dest が指すオブジェクトへ、 count 文字（ unsigned char 型として）をコピーします。
以下のいずれかの条件が満たされる場合、動作は未定義です：
目次パラメータ
戻り値適切に作成されたオブジェクトが存在する場合、そのオブジェクトへのポインタを返します。それ以外の場合は dest を返します。 注記
いくつかのC++コンパイラは、適切なメモリコピーループを
strict aliasing
が同じメモリを2つの異なる型の値として検査することを禁止する場合、
例
このコードを実行
#include <cstdint> #include <cstring> #include <iostream> int main() { // 単純な使用例 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"; // 再解釈 double d = 0.1; // std::int64_t n = *reinterpret_cast<std::int64_t*>(&d); // エイリアシング違反 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; // 宛先バッファでのオブジェクト生成 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++規格に対して遡及的に適用されました。
関連項目
| |||||||||||||||||||||||||||||||||||