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

CKTIS / C++

std::is_trivially_copyable — rozpoznání triviálně kopírovatelných typů

Tato vlastnost z <type_traits> kontroluje při překladu, zda je typ triviálně kopírovatelný. Seznamte se s ekvivalentními zápisy ::value a _v i s omezeními kopírování reprezentace objektu.

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

Syntaxe

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

std::is_trivially_copyable<T> z <type_traits> je typová vlastnost: její ::value je booleovská konstanta, která určuje, zda je T triviálně kopírovatelný. std::is_trivially_copyable_v<T> poskytuje stejnou hodnotu přímo. Použijte ji v static_assert nebo if constexpr ke kontrole požadavků v generickém kódu.

Mezi tyto typy patří skalární typy, triviálně kopírovatelné třídy, pole těchto typů a jejich varianty s kvalifikátory cv. Třída musí mít alespoň jednu přípustnou kopírovací nebo přesouvací operaci; každá taková přípustná operace musí být triviální a destruktor musí být triviální a nesmazaný. Tato vlastnost netestuje vlastnosti standard-layout ani pouze to, zda lze zavolat kopírovací konstruktor.

Předpoklad vyžaduje, aby std::remove_all_extents_t<T> byl úplný typ nebo případně void s kvalifikátory cv. Nekontrolujte tedy třídu před její úplnou definicí. V příkladu vlastnosti vyhovuje Point, zatímco NonTrivial jí kvůli destruktoru definovanému uživatelem nevyhovuje.

U dvou odlišných, existujících objektů stejného triviálně kopírovatelného typu, z nichž žádný není potenciálně se překrývající podobjekt, získá cílový objekt zkopírováním celé reprezentace pomocí std::memcpy hodnotu zdrojového objektu, pokud se zdrojový a cílový rozsah bajtů nepřekrývají. I u odlišných objektů vede překryv těchto rozsahů při volání std::memcpy k nedefinovanému chování. Příklad takto kopíruje Point. Hodnota true však neznamená přenositelný serializační formát: reprezentace může obsahovat výplňové bajty a ukazatele se nestávají kopiemi objektů, na které ukazují. Nadále platí požadavky na dobu života objektů a platný přístup k paměti.

Příklady

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

Výsledek

true
3 7

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje