Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::memcpy i reprezentacje obiektów typów trywialnie kopiowalnych

Dowiedz się, kiedy skopiowanie bajtów zachowuje wartość obiektu w C++23 i dlaczego nie zastępuje kopiowania obiektów dowolnego typu.

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

Składnia

#include <cstring>

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

std::memcpy(dest, src, count) z <cstring> kopiuje dokładnie count bajtów ze źródła do miejsca docelowego. Oba wskaźniki muszą być prawidłowe i niezerowe, nawet gdy count == 0. Zakres źródłowy musi nadawać się do odczytu, a docelowy do zapisu. Wyjście poza zakres lub nakładanie się zakresów oznacza niezdefiniowane zachowanie, a nie zgłoszenie błędu. Przy nakładaniu się zakresów użyj std::memmove; pozostałe warunki nadal obowiązują.

Reprezentacja kompletnego obiektu typu T obejmuje sizeof(T) bajtów. Reprezentacja wartości to bity uczestniczące w kodowaniu wartości; reszta to bity wypełnienia. Dla kompletnego typu obiektowego T sprawdź trywialną kopiowalność za pomocą std::is_trivially_copyable_v<T> z <type_traits>. Cecha ta nie sprawdza wskaźników ani zakresów.

Jeśli skopiujesz wszystkie sizeof(T) bajtów z zainicjalizowanego obiektu do innego, już istniejącego zapisywalnego obiektu tego samego trywialnie kopiowalnego typu T, cel uzyska wartość źródła. Żaden z obiektów nie może być potencjalnie nakładającym się podobiektem: podobiektem klasy bazowej ani niestatyczną składową danych oznaczoną [[no_unique_address]]. Można też zachować reprezentację takiego obiektu w tablicy char, unsigned char lub std::byte i przywrócić niezmienione bajty do tego samego obiektu.

W C++23 funkcja może przed kopiowaniem niejawnie rozpocząć czas życia obiektów typów o niejawnym czasie życia w odpowiednio wyrównanej pamięci docelowej, jeśli pozwala to uzyskać zdefiniowane zachowanie. Nie uruchamia konstruktorów ani nie rozpoczyna w ten sposób życia podobiektów innych typów. Wynik void* wskazuje odpowiedni utworzony obiekt, jeśli taki istnieje; w przeciwnym razie jest równy dest.

Do kopiowania std::string użyj konstruktora kopiującego lub przypisania, nie kopii bajtowej. Skopiowanie wartości wskaźnika nie kopiuje wskazywanego obiektu. Bity wypełnienia sprawiają, że std::memcmp może odróżnić równe wartości, a zależność układu i kolejności bajtów od implementacji wyklucza traktowanie surowej reprezentacji jako przenośnego formatu. Dane z niezaufanego źródła dekoduj i sprawdzaj według ustalonego formatu, zamiast traktować dowolne bajty jako poprawną wartość T.

Przykłady

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

Wynik

copy: 7 42
restored: 7 42

`static_assert` sprawdza typ `Record`. Program kopiuje wartość do `target`, a potem odtwarza pierwotną wartość `source` z tablicy `saved`. Wypisuje wartości składowych, nie surowe bajty.

Powiązane lekcje

  • C++ · Lekcja 16 · Zaawansowany · Wersja: 3

Źródła