Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::is_trivially_copyable — wykrywanie typów trywialnie kopiowalnych

Cecha z <type_traits> sprawdza podczas kompilacji, czy typ jest trywialnie kopiowalny. Poznaj równoważne zapisy ::value i _v oraz ograniczenia kopiowania reprezentacji obiektu.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <type_traits>
std::is_trivially_copyable<T>::value
std::is_trivially_copyable_v<T>

std::is_trivially_copyable<T> z <type_traits> jest cechą typu: jej ::value to stała logiczna określająca, czy T jest trywialnie kopiowalny. std::is_trivially_copyable_v<T> udostępnia tę samą wartość bezpośrednio. Używaj jej w static_assert lub if constexpr, aby sprawdzać wymagania kodu generycznego.

Do takich typów należą typy skalarne, trywialnie kopiowalne klasy, ich tablice oraz odmiany z kwalifikatorami cv. Klasa musi mieć co najmniej jedną dopuszczalną operację kopiowania lub przenoszenia; każda taka dopuszczalna operacja musi być trywialna, a destruktor — trywialny i nieusunięty. To nie jest test właściwości standard-layout ani samej możliwości wywołania konstruktora kopiującego.

Warunek wstępny wymaga, aby std::remove_all_extents_t<T> był typem kompletnym albo void z ewentualnymi kwalifikatorami cv. Nie sprawdzaj więc klasy przed jej pełną definicją. W przykładzie Point spełnia warunek cechy, natomiast NonTrivial nie spełnia go z powodu destruktora zdefiniowanego przez użytkownika.

Jeśli dwa odrębne, istniejące obiekty są tego samego trywialnie kopiowalnego typu i żaden z nich nie jest potencjalnie nakładającym się podobiektem, skopiowanie całej reprezentacji przez std::memcpy nadaje obiektowi docelowemu wartość obiektu źródłowego, pod warunkiem że źródłowy i docelowy zakres bajtów się nie nakładają. Nawet w przypadku odrębnych obiektów nakładanie się tych zakresów powoduje niezdefiniowane zachowanie. Przykład kopiuje tak Point. Wynik true nie oznacza jednak przenośnego formatu serializacji: reprezentacja może zawierać bajty dopełnienia, a wskaźniki nie stają się kopiami wskazywanych obiektów. Nadal obowiązują wymagania dotyczące czasu życia obiektów i poprawnego dostępu do pamięci.

Przykłady

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

struct Point {
    int x;
    int y;
};

struct NonTrivial {
    ~NonTrivial() {}
};

static_assert(std::is_trivially_copyable<Point>::value);
static_assert(!std::is_trivially_copyable_v<NonTrivial>);

int main() {
    Point source{3, 7};
    Point destination{0, 0};
    std::memcpy(&destination, &source, sizeof source);

    std::cout << std::boolalpha
              << std::is_trivially_copyable_v<Point> << '\n'
              << destination.x << ' ' << destination.y << '\n';
}

Wynik

true
3 7

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła