WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::numeric_limits — Grenzen und Eigenschaften numerischer Typen

std::numeric_limits<T> aus <limits> stellt Grenzen und Darstellungseigenschaften von T bereit. Erfahre, worin sich min() und lowest() unterscheiden, was digits zählt und wie sich die IEC-559-Konformität prüfen lässt, ohne eine bestimmte Typgröße vorauszusetzen.

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

Syntax

#include <limits>
std::numeric_limits<T>::min()
std::numeric_limits<T>::max()
std::numeric_limits<T>::digits
std::numeric_limits<T>::is_iec559

std::numeric_limits<T> aus <limits> beschreibt die Darstellung eines arithmetischen Typs T in der jeweiligen Implementierung. Seine statischen constexpr-Elemente lassen sich ohne Objekt verwenden, auch in static_assert. Prüfe in generischem Code zuerst is_specialized, bevor du dich auf Eigenschaften eines unbekannten Typs verlässt.

std::numeric_limits<T>::max() liefert den größten endlichen Wert, nicht Unendlich. Bei Ganzzahltypen ist std::numeric_limits<T>::min() die untere Grenze; bei Gleitkommatypen ist es der kleinste positive normalisierte Wert. lowest() liefert den kleinsten endlichen Wert, nicht negativ unendlich, selbst wenn der Typ negativ unendlich darstellen kann. denorm_min() liefert, sofern vorhanden, den kleinsten positiven subnormalen Wert; andernfalls den kleinsten positiven normalisierten Wert.

std::numeric_limits<T>::digits zählt Ziffern zur Basis radix: bei Ganzzahlen die Wertbits ohne Vorzeichenbit und bei Gleitkommatypen die Signifikandenziffern in dieser Basis. Im Allgemeinen ist das keine Anzahl von Dezimalziffern; diese Eigenschaft beschreibt digits10.

std::numeric_limits<T>::is_iec559 ist eine boolesche Konstante, die angibt, ob der Typ ISO/IEC 60559 (IEEE 754) entspricht. Nimm weder an, dass sie für float immer true ist, noch dass digits einen bestimmten Wert hat. Das Beispiel verwendet garantierte Eigenschaften von bool und Vergleiche für float und hängt daher nicht von üblichen Darstellungsgrößen ab.

In diesem Eintrag behandelte Referenzbezeichner: std::numeric_limits::is_iec559, std::numeric_limits::digits, std::numeric_limits::max, std::numeric_limits::min.

Beispiele

#include <iostream>
#include <limits>

int main() {
    using B = std::numeric_limits<bool>;
    using F = std::numeric_limits<float>;

    static_assert(B::is_specialized);
    static_assert(B::digits == 1);
    static_assert(!B::is_iec559);

    std::cout << std::boolalpha;
    std::cout << "bool range: " << B::min() << ' ' << B::max() << '\n';
    std::cout << "bool digits: " << B::digits << '\n';
    std::cout << "bool IEC 559: " << B::is_iec559 << '\n';
    std::cout << "float min positive: " << (F::min() > 0.0f) << '\n';
    std::cout << "float lowest negative: " << (F::lowest() < 0.0f) << '\n';
}

Ergebnis

bool range: false true
bool digits: 1
bool IEC 559: false
float min positive: true
float lowest negative: true

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