WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::is_trivially_copyable — trivial kopierbare Typen erkennen

Dieses Trait aus <type_traits> prüft zur Compile-Zeit, ob ein Typ trivial kopierbar ist. Lerne die gleichwertigen Schreibweisen ::value und _v sowie die Grenzen beim Kopieren der Objektrepräsentation kennen.

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

Syntax

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

std::is_trivially_copyable<T> aus <type_traits> ist ein Typ-Trait: Sein ::value ist eine boolesche Konstante, die angibt, ob T trivial kopierbar ist. std::is_trivially_copyable_v<T> stellt denselben Wert direkt bereit. Verwende es in static_assert oder if constexpr, um Anforderungen in generischem Code zu prüfen.

Zu diesen Typen zählen skalare Typen, trivial kopierbare Klassen, Arrays dieser Typen und ihre cv-qualifizierten Varianten. Eine Klasse muss mindestens eine zulässige Kopier- oder Verschiebeoperation haben; jede solche zulässige Operation muss trivial sein, und ihr Destruktor muss trivial und nicht gelöscht sein. Dies prüft weder Eigenschaften von standard-layout noch lediglich, ob ein Kopierkonstruktor aufgerufen werden kann.

Die Vorbedingung verlangt, dass std::remove_all_extents_t<T> ein vollständiger Typ oder möglicherweise cv-qualifiziertes void ist. Prüfe daher eine Klasse nicht vor ihrer vollständigen Definition. Im Beispiel erfüllt Point das Trait, NonTrivial hingegen nicht, da sein Destruktor vom Benutzer bereitgestellt wird.

Bei zwei verschiedenen, existierenden Objekten desselben trivial kopierbaren Typs, von denen keines ein potenziell überlappendes Unterobjekt ist, erhält das Zielobjekt durch Kopieren der gesamten Repräsentation mit std::memcpy den Wert des Quellobjekts, sofern sich Quell- und Zielbytebereich nicht überlappen. Überlappen sich die Bytebereiche, führt der Aufruf von std::memcpy auch bei verschiedenen Objekten zu undefiniertem Verhalten. Das Beispiel kopiert Point auf diese Weise. true bedeutet jedoch nicht, dass ein portables Serialisierungsformat vorliegt: Die Repräsentation kann Padding-Bytes enthalten, und Zeiger werden nicht zu Kopien der Objekte, auf die sie zeigen. Anforderungen an die Objektlebensdauer und den gültigen Speicherzugriff gelten weiterhin.

Beispiele

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

Ergebnis

true
3 7

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