Namensräume
Varianten
Aktionen

std::underlying_type

Von cppreference.com
< cpp‎ | types
 
C++
 
Metaprogrammierungsbibliothek
Typmerkmale
Typkategorien
(C++11)
(C++11)(DR*)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11) 
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Typeneigenschaften
(C++11)
(C++11)
(C++11)
(C++11)
(C++14)
(C++11)
(C++17)
(C++23)
(C++11)(deprecated in C++26)
(C++11)
(C++11)
(C++11)(bis C++20*)
(C++11)(veraltet in C++20)
(C++11)
(C++11)
(C++20)
(C++20)
(C++23)
(C++17)
Typmerkmalskonstanten
(C++11)(C++17)(C++11)(C++11)
Metafunktionen
(C++17)
(C++17)
(C++17)
Unterstützte Operationen
Beziehungen und Eigenschaftsabfragen
Typmodifikationen
(C++11)(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Typentransformationen
(C++11)(veraltet in C++23)
(C++11)(veraltet in C++23)
(C++11)
(C++20)
(C++11)(bis C++20*)(C++17)

(C++11)
(C++11)
(C++20)
underlying_type
(C++11)
(C++20)
(C++11)
(C++17)
Rationale Arithmetik zur Compilezeit
Ganzzahlsequenzen zur Compilezeit
(C++14)
 
Definiert in der Kopfdatei <type_traits>
template< class T >
struct underlying_type;
 (seit C++11)

Wenn T ein vollständiger Aufzählungstyp (enum) ist, wird ein Mitglied-Typedef type bereitgestellt, das den zugrundeliegenden Typ von T benennt.

Andernfalls ist das Verhalten undefiniert.

 (bis C++20)

Andernfalls, wenn T kein Aufzählungstyp ist, gibt es kein Mitglied type. Andernfalls (T ist ein unvollständiger Aufzählungstyp), ist das Programm schlecht geformt.

 (seit C++20)

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

Inhalt

[bearbeiten] Member types

Name Definition
type der zugrundeliegende Typ von T

[bearbeiten] Helper types

template< class T >
using underlying_type_t = typename underlying_type<T>::type;
 (seit C++14)

[bearbeiten] Notes

Jeder Aufzählungstyp hat einen zugrundeliegenden Typ, der

  1. explizit angegeben werden kann (sowohl für gewichtete als auch für ungewichtete Aufzählungen);
  2. weggelassen werden kann, in diesem Fall ist er für gewichtete Aufzählungen int oder für ungewichtete Aufzählungen ein implementierungsdefinierter ganzzahliger Typ, der alle Werte der Aufzählung darstellen kann.

[bearbeiten] Example

Führen Sie diesen Code aus
#include <iostream>
#include <type_traits>
 
enum e1 {};
enum class e2 {};
enum class e3 : unsigned {};
enum class e4 : int {};
 
int main()
{
    constexpr bool e1_t = std::is_same_v<std::underlying_type_t<e1>, int>;
    constexpr bool e2_t = std::is_same_v<std::underlying_type_t<e2>, int>;
    constexpr bool e3_t = std::is_same_v<std::underlying_type_t<e3>, int>;
    constexpr bool e4_t = std::is_same_v<std::underlying_type_t<e4>, int>;
 
    std::cout
        << "underlying type for 'e1' is " << (e1_t ? "int" : "non-int") << '\n'
        << "underlying type for 'e2' is " << (e2_t ? "int" : "non-int") << '\n'
        << "underlying type for 'e3' is " << (e3_t ? "int" : "non-int") << '\n'
        << "underlying type for 'e4' is " << (e4_t ? "int" : "non-int") << '\n';
}

Mögliche Ausgabe

underlying type for 'e1' is non-int
underlying type for 'e2' is int
underlying type for 'e3' is non-int
underlying type for 'e4' is int

[bearbeiten] Defect reports

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 2396 C++11 unvollständige Aufzählungstypen waren zulässig vollständiger Aufzählungstyp erforderlich

[bearbeiten] See also

(C++11)
 prüft, ob ein Typ ein Aufzählungstyp ist
(Klassenvorlage) [bearbeiten]
(C++23)
 prüft, ob ein Typ ein namensgebender Aufzählungstyp ist
(Klassenvorlage) [bearbeiten]
(C++23)
 konvertiert eine Aufzählung in ihren zugrundeliegenden Typ
(Funktionsvorlage) [edit]
Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/types/underlying_type&oldid=152571"