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.