WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::is_nothrow_copy_constructible — nicht auslösende Kopierkonstruktion

Dieses Trait aus <type_traits> prüft zur Compilezeit, ob die Konstruktion von T aus const T& gültig ist und bekanntermaßen keine Ausnahme auslöst. std::is_nothrow_copy_constructible<T>::value und std::is_nothrow_copy_constructible_v<T> stellen dasselbe bool-Ergebnis bereit.

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

Syntax

#include <type_traits>

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

std::is_nothrow_copy_constructible<T> ist ein Klassentemplate aus <type_traits>, dessen Member ::value eine Konstante vom Typ bool ist. std::is_nothrow_copy_constructible_v<T> ist ein Variablen-Template, das denselben Wert bereitstellt. Das Ergebnis kann in static_assert und if constexpr verwendet werden.

Für einen Typ T, für den eine Referenz gebildet werden kann, entspricht das Ergebnis std::is_nothrow_constructible_v<T, const T&>: Die direkte Initialisierung muss gültig sein und bekanntermaßen keine Ausnahme auslösen. Für andere Typen ist das Ergebnis false. Der Test führt den Konstruktor nicht aus; auch ein leerer Konstruktor, der als noexcept(false) deklariert ist, ergibt false.

Geprüft wird die Konstruktion, nicht die Zuweisung oder triviale Kopierbarkeit. Wählt die Überladungsauflösung für die Konstruktion aus const T& einen gelöschten oder nicht zugänglichen Konstruktor aus, ist das Ergebnis false. Hat eine Klasse T beispielsweise einen gelöschten T(T&) und einen öffentlichen, als noexcept deklarierten T(const T&), wählt die Überladungsauflösung den öffentlichen Konstruktor aus. Das allein garantiert noch kein true: Ist der Destruktor gelöscht oder nicht zugänglich, ist die im Test betrachtete hypothetische Variablendefinition ungültig, und das Ergebnis ist false. Bei Referenztypen wird die Referenzbindung geprüft, nicht das Kopieren des referenzierten Objekts; beispielsweise ist std::is_nothrow_copy_constructible_v<int&> gleich true.

T muss ein vollständiger Typ, möglicherweise cv-qualifiziertes void oder ein Array unbekannter Größe sein. Verwende dieses Trait nicht, um eine vorwärtsdeklarierte Klasse vor ihrer Definition zu untersuchen. Füge keine eigenen Spezialisierungen dieser Templates hinzu: Andernfalls ist das Verhalten des Programms undefiniert.

Beispiele

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

Ergebnis

true
false
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen