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

CKTIS / C++

std::is_nothrow_copy_constructible — kopírovací konstrukce bez výjimky

Tento trait z <type_traits> kontroluje při kompilaci, zda je konstrukce T z const T& platná a je známo, že nevyvolá výjimku. std::is_nothrow_copy_constructible<T>::value a std::is_nothrow_copy_constructible_v<T> zpřístupňují stejný výsledek typu bool.

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

Syntaxe

#include <type_traits>

std::is_nothrow_copy_constructible<T>::value
std::is_nothrow_copy_constructible_v<T>

std::is_nothrow_copy_constructible<T> je šablona třídy z <type_traits>, jejíž člen ::value je konstanta typu bool. std::is_nothrow_copy_constructible_v<T> je šablona proměnné zpřístupňující stejnou hodnotu. Výsledek lze použít v static_assert a if constexpr.

Pro typ T, ke kterému lze vytvořit referenci, se výsledek rovná std::is_nothrow_constructible_v<T, const T&>: přímá inicializace musí být platná a musí být známo, že nevyvolá výjimku. Pro ostatní typy je výsledek false. Test konstruktor nespouští; i prázdný konstruktor deklarovaný jako noexcept(false) dává false.

Tento trait testuje konstrukci, nikoli přiřazení nebo triviální kopírování. Pokud se při řešení přetížení pro konstrukci z const T& vybere odstraněný nebo nepřístupný konstruktor, je výsledek false. Například u třídy T s odstraněným konstruktorem T(T&) a veřejným konstruktorem T(const T&) deklarovaným jako noexcept se při řešení přetížení vybere veřejný konstruktor. Samotný výběr ale nezaručuje výsledek true: pokud je destruktor odstraněný nebo nepřístupný, hypotetická definice proměnné posuzovaná v testu není platná a výsledek je false. U referenčních typů kontroluje navázání reference, nikoli kopírování odkazovaného objektu; například std::is_nothrow_copy_constructible_v<int&> je true.

T musí být úplný typ, případně void s cv kvalifikátory, nebo pole s neznámou velikostí. Nepoužívejte tento trait ke zkoumání dopředně deklarované třídy před její definicí. Nepřidávejte vlastní specializace těchto šablon: chování programu je v takovém případě nedefinované.

Příklady

#include <iostream>
#include <type_traits>

struct Safe {
    Safe(const Safe&) noexcept {}
};

struct Risky {
    Risky(const Risky&) noexcept(false) {}
};

struct Blocked {
    Blocked(const Blocked&) = delete;
};

static_assert(std::is_nothrow_copy_constructible<Safe>::value);
static_assert(!std::is_nothrow_copy_constructible_v<Risky>);
static_assert(!std::is_nothrow_copy_constructible_v<Blocked>);

int main() {
    std::cout << std::boolalpha
              << std::is_nothrow_copy_constructible<Safe>::value << '\n'
              << std::is_nothrow_copy_constructible_v<Risky> << '\n'
              << std::is_nothrow_copy_constructible_v<Blocked> << '\n';
}

Výsledek

true
false
false

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