Namespaces
Variants

std:: is_empty

From cppreference.net
Metaprogramming library
Type traits
Type categories
(C++11)
(C++11) ( DR* )
Type properties
(C++11)
is_empty
(C++11)
(C++14)
(C++11) (deprecated in C++26)
(C++11) ( until C++20* )
(C++11) (deprecated in C++20)
(C++11)
Type trait constants
Metafunctions
(C++17)
Supported operations
Relationships and property queries
Type modifications
Type transformations
(C++11) (deprecated in C++23)
(C++11) (deprecated in C++23)
(C++11)
(C++11) ( until C++20* ) (C++17)

Compile-time rational arithmetic
Compile-time integer sequences
Definiert im Header <type_traits>
template < class T >
struct is_empty ;
(seit C++11)

std::is_empty ist ein UnaryTypeTrait .

Wenn T ein leerer Typ ist (d.h. ein nicht-Union-Klassentyp ohne nicht-statische Datenelemente außer Bitfeldern der Größe 0, ohne virtuelle Funktionen, ohne virtuelle Basisklassen und ohne nicht-leere Basisklassen), liefert die Konstante value den Wert true . Für jeden anderen Typ ist value false .

Wenn T ein unvollständiger Nicht-Union-Klassentyp ist, ist das Verhalten undefiniert.

Wenn das Programm Spezialisierungen für std::is_empty oder std::is_empty_v hinzufügt, ist das Verhalten undefiniert.

Inhaltsverzeichnis

Template-Parameter

T - ein zu prüfender Typ

Hilfsvariablen-Template

template < class T >
constexpr bool is_empty_v = is_empty < T > :: value ;
(seit C++17)

Geerbt von std:: integral_constant

Member-Konstanten

value
[static]
true wenn T ein leerer Klassentyp ist, false andernfalls
(öffentliche statische Member-Konstante)

Member-Funktionen

operator bool
konvertiert das Objekt zu bool , gibt value zurück
(öffentliche Member-Funktion)
operator()
(C++14)
gibt value zurück
(öffentliche Member-Funktion)

Member-Typen

Typ Definition
value_type bool
type std:: integral_constant < bool , value >

Hinweise

Das Erben von leeren Basisklassen erhöht normalerweise nicht die Größe einer Klasse aufgrund der Empty-Base-Optimierung .

std::is_empty<T> und alle anderen Typmerkmale sind leere Klassen.

Beispiel

#include <iostream>
#include <type_traits>
struct A {};
static_assert(std::is_empty_v<A> == true);
struct B { int m; };
static_assert(std::is_empty_v<B> == false);
struct C { static int m; };
static_assert(std::is_empty_v<C> == true);
struct D { virtual ~D(); };
static_assert(std::is_empty_v<D> == false);
union E {};
static_assert(std::is_empty_v<E> == false);
struct F { [[no_unique_address]] E e; };
struct G
{
    int:0;
    // C++ standard allow "as a special case, an unnamed bit-field with a width of zero
    // specifies alignment of the next bit-field at an allocation unit boundary.
    // Only when declaring an unnamed bit-field may the width be zero."
};
static_assert(std::is_empty_v<G>); // holds only unnamed bit-fields of zero width
int main()
{
    std::cout << std::boolalpha;
    std::cout << "F: " << std::is_empty_v<F> << '\n'; // the result is ABI-dependent
}

Mögliche Ausgabe:

F: true

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 2015 C++11 das Verhalten war undefiniert falls
T ein unvollständiger Union-Typ ist
die Basis-Charakteristik ist
std::false_type in diesem Fall

Siehe auch

(C++11)
prüft, ob ein Typ ein Nicht-Union-Klassentyp ist
(Klassen-Template)