Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::memcpy a reprezentace objektů triviálně kopírovatelných typů

Zjistěte, kdy kopírování bajtů v C++23 zachovává hodnotu objektu a proč nenahrazuje kopírování objektů libovolných typů.

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

Syntaxe

#include <cstring>

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

std::memcpy(dest, src, count) z <cstring> zkopíruje přesně count bajtů ze zdroje do cíle. Oba ukazatele musí být platné a nenulové, i když count == 0. Zdrojový rozsah musí být čitelný a do cílového musí být možné zapisovat. Překročení hranic rozsahu nebo překryv rozsahů vede k nedefinovanému chování, nikoli k ohlášení chyby. Při překryvu použijte std::memmove; ostatní podmínky stále platí.

Reprezentace úplného objektu typu T zabírá sizeof(T) bajtů. Bity kódující hodnotu tvoří reprezentaci hodnoty; zbývající bity jsou výplňové. Pro úplný objektový typ T ověřte triviální kopírovatelnost pomocí std::is_trivially_copyable_v<T> z <type_traits>. Tato typová vlastnost nekontroluje ukazatele ani rozsahy.

Když zkopírujete všech sizeof(T) bajtů z inicializovaného objektu do jiného objektu stejného triviálně kopírovatelného typu T, jehož doba života již začala a do něhož lze zapisovat, cíl získá hodnotu zdroje. Ani jeden nesmí být potenciálně se překrývajícím podobjektem: podobjektem základní třídy nebo nestatickým datovým členem označeným [[no_unique_address]]. Reprezentaci vhodného objektu můžete také uložit do pole typu char, unsigned char nebo std::byte a nezměněné bajty obnovit v témže objektu.

V C++23 může operace před kopírováním v náležitě zarovnané cílové paměti implicitně zahájit dobu života objektů typů s implicitní dobou života, pokud tím vznikne definované chování. Nevolá konstruktory ani nezahajuje dobu života podobjektů, jejichž typ implicitní dobu života nemá. Výsledný void* ukazuje na vhodný vytvořený objekt, pokud existuje; jinak je výsledkem dest.

std::string kopírujte kopírovacím konstruktorem nebo přiřazením, ne kopírováním bajtů. Kopie hodnoty ukazatele nekopíruje objekt, na který ukazuje. Kvůli výplňovým bitům může std::memcmp rozlišit stejné hodnoty; rozložení v paměti a pořadí bajtů závisejí na implementaci, takže surová reprezentace není přenositelný formát. Nedůvěryhodná data dekódujte a ověřujte podle definovaného formátu, místo abyste libovolné bajty považovali za platnou hodnotu typu T.

Příklady

#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';
}

Výsledek

copy: 7 42
restored: 7 42

`static_assert` ověří typ `Record`. Program zkopíruje hodnotu do `target` a poté obnoví původní hodnotu `source` z pole `saved`. Vypíše hodnoty členů, nikoli surové bajty.

Související lekce

  • C++ · Lekce 16 · Pokročilá · Verze: 3

Zdroje