Namensräume
Varianten
Aktionen

std::is_unsigned

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

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

std::is_unsigned ist ein UnaryTypeTrait.

Prüft, ob T ein vorzeichenloser arithmetischer Typ ist.

  • Wenn std::is_arithmetic<T>::value true ist, stellt es die Member-Konstante value mit dem Wert T(0) < T(-1) bereit.
  • Andernfalls stellt es die Member-Konstante value mit dem Wert false bereit.

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

Inhalt

[bearbeiten] Template-Parameter

T - ein zu prüfender Typ

[bearbeiten] Hilfsvariablen-Template

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

Abgeleitet von std::integral_constant

Member-Konstanten

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

Memberfunktionen

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

Membertypen

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

[bearbeiten] Mögliche Implementierung

namespace detail
{
    template<typename T,bool = std::is_arithmetic<T>::value>
    struct is_unsigned : std::integral_constant<bool, T(0) < T(-1)> {};
 
    template<typename T>
    struct is_unsigned<T,false> : std::false_type {};
} // namespace detail
 
template<typename T>
struct is_unsigned : detail::is_unsigned<T>::type {};

[bearbeiten] Beispiel

#include <iostream>
#include <type_traits>
 
class A {};
static_assert(std::is_unsigned_v<A> == false);
 
enum B : unsigned {};
static_assert(std::is_unsigned_v<B> == false);
 
enum class C : unsigned {};
static_assert(std::is_unsigned_v<C> == false);
 
struct S { unsigned p : 1; int q : 1; };
static_assert
(
    std::is_unsigned_v<decltype(S::p)> not_eq
    std::is_unsigned_v<decltype(S::q)>
);
 
static_assert
(
    std::is_unsigned_v<float> == false &&
    std::is_unsigned_v<signed int> == false &&
    std::is_unsigned_v<unsigned int> == true &&
    std::is_unsigned_v<bool> == true
);
 
int main() 
{
    // signedness of char is implementation-defined:
    std::cout << std::boolalpha << std::is_unsigned<char>::value << '\n';
}

Mögliche Ausgabe

false

[bearbeiten] 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 2197 C++11 value könnte true sein, auch wenn T kein arithmetischer Typ ist kann in diesem Fall nur false sein

[bearbeiten] Siehe auch

(C++11)
prüft, ob ein Typ ein vorzeichenbehafteter arithmetischer Typ ist
(Klassenvorlage) [bearbeiten]
[static]
identifiziert vorzeichenbehaftete Typen
(öffentliche statische Member-Konstante von std::numeric_limits<T>) [bearbeiten]
prüft, ob ein Typ ein arithmetischer Typ ist
(Klassenvorlage) [bearbeiten]
erhält den entsprechenden vorzeichenbehafteten Typ für den gegebenen ganzzahligen Typ
(Klassenvorlage) [bearbeiten]
erhält den entsprechenden vorzeichenbehafteten Typ für den gegebenen ganzzahligen Typ
(Klassenvorlage) [bearbeiten]