WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::memcpy und Objektrepräsentationen trivial kopierbarer Typen

Lerne, wann das Kopieren von Bytes in C++23 einen Objektwert erhält und warum es das Kopieren beliebiger Objekte nicht ersetzt.

Version: ISO C++23; implementation support may vary

Syntax

#include <cstring>

// Call: destination first; count is in bytes.
std::memcpy(dest, src, count);

std::memcpy(dest, src, count) aus <cstring> kopiert genau count Bytes von der Quelle zum Ziel. Beide Zeiger müssen gültig sein und dürfen auch bei count == 0 keine Nullzeiger sein. Der Quellbereich muss lesbar, der Zielbereich beschreibbar sein. Zugriffe außerhalb der Bereiche oder eine Überlappung führen zu undefiniertem Verhalten, nicht zu einer Fehlermeldung. Bei Überlappung verwende std::memmove; die übrigen Voraussetzungen gelten weiterhin.

Die Objektrepräsentation eines vollständigen Objekts vom Typ T umfasst sizeof(T) Bytes. Die Bits, die den Wert kodieren, bilden die Wertrepräsentation; die übrigen sind Füllbits. Bei einem vollständigen Objekttyp T prüft std::is_trivially_copyable_v<T> aus <type_traits>, ob der Typ trivial kopierbar ist. Das Typmerkmal prüft weder Zeiger noch Speicherbereiche.

Werden alle sizeof(T) Bytes eines initialisierten Objekts in ein anderes, bereits lebendes und beschreibbares Objekt desselben trivial kopierbaren Typs T kopiert, erhält das Ziel den Wert der Quelle. Keines der Objekte darf ein potenziell überlappendes Teilobjekt sein, also ein Basisklassen-Teilobjekt oder ein mit [[no_unique_address]] markiertes nichtstatisches Datenelement. Die Repräsentation eines solchen geeigneten Objekts lässt sich auch in einem Array aus char, unsigned char oder std::byte sichern und unverändert in dasselbe Objekt zurückkopieren.

In C++23 kann die Operation vor dem Kopieren in passend ausgerichtetem Zielspeicher implizit die Lebensdauer von Objekten mit impliziter Lebensdauer beginnen lassen, wenn sich dadurch definiertes Verhalten ergibt. Sie ruft keine Konstruktoren auf und startet so auch nicht die Lebensdauer von Teilobjekten, deren Typ keine implizite Lebensdauer erlaubt. Der Rückgabewert vom Typ void* zeigt auf ein geeignetes erzeugtes Objekt, wenn es eines gibt; andernfalls ist er dest.

Kopiere einen std::string durch Kopierkonstruktion oder Zuweisung, nicht byteweise. Beim Kopieren eines Zeigerwerts wird das referenzierte Objekt nicht mitkopiert. Wegen Füllbits kann std::memcmp gleiche Werte unterscheiden, und implementierungsabhängige Speicheranordnung und Byte-Reihenfolge machen rohe Repräsentationen als portables Format ungeeignet. Dekodiere und prüfe nicht vertrauenswürdige Daten nach einem festgelegten Format, statt beliebige Bytes als gültigen Wert vom Typ T zu behandeln.

Beispiele

#include <cstddef>
#include <cstring>
#include <iostream>
#include <type_traits>

struct Record {
    int id;
    int score;
};

static_assert(std::is_trivially_copyable_v<Record>);

int main() {
    Record source{7, 42};
    Record target{};
    std::memcpy(&target, &source, sizeof(Record));
    std::cout << "copy: " << target.id << ' ' << target.score << '\n';

    std::byte saved[sizeof(Record)];
    std::memcpy(saved, &source, sizeof(Record));
    source = Record{0, 0};
    std::memcpy(&source, saved, sizeof(Record));
    std::cout << "restored: " << source.id << ' ' << source.score << '\n';
}

Ergebnis

copy: 7 42
restored: 7 42

`static_assert` prüft den Typ `Record`. Das Programm kopiert den Wert nach `target` und stellt anschließend den ursprünglichen Wert von `source` aus `saved` wieder her. Es gibt die Werte der Datenelemente aus, keine Rohbytes.

Zugehörige Lektionen

  • C++ · Lektion 16 · Fortgeschritten · Version: 3

Quellen