std::extent
Von cppreference.com
| Definiert in der Kopfdatei <type_traits> |
||
| template< class T, unsigned N = 0 > struct extent; |
(seit C++11) | |
Wenn T ein Array-Typ ist, stellt die Member-Konstante value die Anzahl der Elemente entlang der N-ten Dimension des Arrays dar, wenn N im Bereich [0, std::rank<T>::value) liegt. Für jeden anderen Typ, oder wenn T ein Array unbekannter Größe entlang seiner ersten Dimension ist und N gleich 0 ist, ist value gleich 0.
Wenn das Programm Spezialisierungen für std::extent oder std::extent_v(seit C++17) hinzufügt, ist das Verhalten undefiniert.
Inhalt |
[bearbeiten] Hilfsvariablen-Template
| template< class T, unsigned N = 0 > constexpr std::size_t extent_v = extent<T, N>::value; |
(seit C++17) | |
Abgeleitet von std::integral_constant
Member-Konstanten
| value [static] |
die Anzahl der Elemente entlang der N-ten Dimension von T(öffentliche statische Member-Konstante) |
Memberfunktionen
| operator std::size_t |
konvertiert das Objekt in std::size_t, gibt value zurück (öffentliche Memberfunktion) |
| operator() (C++14) |
gibt value zurück (öffentliche Memberfunktion) |
Membertypen
| Typ | Definition |
value_type
|
std::size_t |
type
|
std::integral_constant<std::size_t, value> |
[bearbeiten] Mögliche Implementierung
template<class T, unsigned N = 0> struct extent : std::integral_constant<std::size_t, 0> {}; template<class T> struct extent<T[], 0> : std::integral_constant<std::size_t, 0> {}; template<class T, unsigned N> struct extent<T[], N> : std::extent<T, N - 1> {}; template<class T, std::size_t I> struct extent<T[I], 0> : std::integral_constant<std::size_t, I> {}; template<class T, std::size_t I, unsigned N> struct extent<T[I], N> : std::extent<T, N - 1> {}; |
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#include <type_traits> static_assert( std::extent_v<int[3]> == 3 && // default dimension is 0 std::extent_v<int[3], 0> == 3 && // the same as above std::extent_v<int[3][4], 0> == 3 && std::extent_v<int[3][4], 1> == 4 && std::extent_v<int[3][4], 2> == 0 && std::extent_v<int[]> == 0 ); int main() { const auto ext = std::extent<int['*']>{}; static_assert(ext == 42); // with implicit conversion to std::size_t const int ints[]{1, 2, 3, 4}; static_assert(std::extent_v<decltype(ints)> == 4); // array size [[maybe_unused]] int ary[][3] = {{1, 2, 3}}; // ary[0] is of type reference to 'int[3]', so, the extent // cannot be calculated correctly and it returns 0 static_assert(std::is_same_v<decltype(ary[0]), int(&)[3]>); static_assert(std::extent_v<decltype(ary[0])> == 0); // removing reference gives correct extent value 3 static_assert(std::extent_v<std::remove_cvref_t<decltype(ary[0])>> == 3); }
[bearbeiten] Siehe auch
| (C++11) |
prüft, ob ein Typ ein Arraytyp ist (Klassenvorlage) |
| (C++11) |
erhält die Anzahl der Dimensionen eines Arraytyps (Klassenvorlage) |
| (C++11) |
entfernt eine Ausdehnung vom gegebenen Array-Typ (Klassenvorlage) |
| (C++11) |
entfernt alle Ausdehnungen vom gegebenen Array-Typ (Klassenvorlage) |
| (C++23) |
ein Deskriptor eines multidimensionalen Indexraums eines bestimmten Rangs (class template) |
