std::numeric_limits<T>::max_digits10

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Dienstprogramm-Bibliotheken

Sprachunterstützung Typunterstützung (Basistypen, RTTI) Bibliotheks-Feature-Test-Makros (C++20) Programm-Dienstprogramme Variadische Funktionen initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Coroutine-Unterstützung (C++20) Vertragsunterstützung (C++26) Drei-Wege-Vergleich three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Allgemeine Hilfsmittel Funktionsobjekte Bit-Manipulation (C++20) bitset hash (C++11) Relationale Operatoren (in C++20 veraltet) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Ganzzahl-Vergleichsfunktionen cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap und Typ-Operationen swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Gemeinsame Vokabulartypen pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Typunterstützung

Basistypen
Ganzzahltypen mit fester Breite (C++11)
Gleitkommatypen mit fester Breite (C++23)
ptrdiff_t size_t max_align_t (C++11)     byte (C++17)	nullptr_t (C++11) offsetof NULL
Numerische Grenzwerte
numeric_limits
C-Schnittstelle für numerische Grenzwerte
Laufzeit-Typinformationen
type_info type_index (C++11)	bad_typeid bad_cast

 

std::numeric_limits

Statische Konstanten

numeric_limits::is_specialized

numeric_limits::is_signed

numeric_limits::is_integer

numeric_limits::is_exact

numeric_limits::has_infinity

numeric_limits::has_quiet_NaN

numeric_limits::has_signaling_NaN

numeric_limits::has_denorm

numeric_limits::has_denorm_loss

numeric_limits::round_style

numeric_limits::is_iec559

numeric_limits::is_bounded

numeric_limits::is_modulo

numeric_limits::digits

numeric_limits::digits10

numeric_limits::max_digits10 (C++11)

numeric_limits::radix

numeric_limits::min_exponent

numeric_limits::min_exponent10

numeric_limits::max_exponent

numeric_limits::max_exponent10

numeric_limits::traps

numeric_limits::tinyness_before

Statische Member-Funktionen

numeric_limits::min

numeric_limits::lowest (C++11)

numeric_limits::max

numeric_limits::epsilon

numeric_limits::round_error

numeric_limits::infinity

numeric_limits::quiet_NaN

numeric_limits::signaling_NaN

numeric_limits::denorm_min

Hilfstypen

float_round_style

float_denorm_style

 

static constexpr int max_digits10		(seit C++11)

Der Wert von std::numeric_limits<T>::max_digits10 ist die Anzahl der Dezimalziffern, die erforderlich sind, um alle unterschiedlichen Werte des Typs T eindeutig darzustellen, wie sie z. B. für die Serialisierung/Deserialisierung in Text erforderlich sind. Diese Konstante ist für alle Gleitkommatypen aussagekräftig.

Standard-Spezialisierungen

T	Wert von std::numeric_limits<T>::max_digits10
/* nicht spezialisiert */	​0​
bool	​0​
char	​0​
signed char	​0​
unsigned char	​0​
wchar_t	​0​
char8_t (seit C++20)	​0​
char16_t	​0​
char32_t	​0​
short	​0​
unsigned short	​0​
int	​0​
unsigned int	​0​
long	​0​
unsigned long	​0​
long long	​0​
unsigned long long	​0​
float	FLT_DECIMAL_DIG oder std::ceil(std::numeric_limits<float>::digits * std::log10(2) + 1)
double	DBL_DECIMAL_DIG oder std::ceil(std::numeric_limits<double>::digits * std::log10(2) + 1)
long double	DECIMAL_DIG oder LDBL_DECIMAL_DIG oder std::ceil(std::numeric_limits<long double>::digits * std::log10(2) + 1)

Anmerkungen

Im Gegensatz zu den meisten mathematischen Operationen ist die Umwandlung eines Gleitkommawerts in Text und zurück *exakt*, solange mindestens max_digits10 verwendet wurden (9 für float, 17 für double): Es ist garantiert, dass derselbe Gleitkommawert erzeugt wird, auch wenn die Zwischentextdarstellung nicht exakt ist. Es können über hundert Dezimalstellen erforderlich sein, um den präzisen Wert eines float in Dezimaldarstellung zu repräsentieren.

Beispiel

Führen Sie diesen Code aus

#include <cmath>
#include <iomanip>
#include <iostream>
#include <limits>
#include <sstream>
 
int main()
{
    float value = 10.0000086;
 
    constexpr auto digits10 = std::numeric_limits<decltype(value)>::digits10;
    constexpr auto max_digits10 = std::numeric_limits<decltype(value)>::max_digits10;
    constexpr auto submax_digits10 = max_digits10 - 1;
 
    std::cout << "float:\n"
                 "       digits10 is " << digits10 << " digits\n"
                 "   max_digits10 is " << max_digits10 << " digits\n"
                 "submax_digits10 is " << submax_digits10 << " digits\n\n";
 
    const auto original_precision = std::cout.precision();
    for (auto i = 0; i < 5; ++i)
    {
        std::cout
            << "   max_digits10: " << std::setprecision(max_digits10) << value << "\n"
               "submax_digits10: " << std::setprecision(submax_digits10) << value
            << "\n\n";
 
        value = std::nextafter(value, std::numeric_limits<decltype(value)>::max());
    }
    std::cout.precision(original_precision);
}

Ausgabe

float:
       digits10 is 6 digits
   max_digits10 is 9 digits
submax_digits10 is 8 digits
 
   max_digits10: 10.0000086
submax_digits10: 10.000009
 
   max_digits10: 10.0000095
submax_digits10: 10.00001
 
   max_digits10: 10.0000105
submax_digits10: 10.00001
 
   max_digits10: 10.0000114
submax_digits10: 10.000011
 
   max_digits10: 10.0000124
submax_digits10: 10.000012

Siehe auch

radix [static]	die Basis oder der ganzzahlige Basiswert, der für die Darstellung des gegebenen Typs verwendet wird (öffentliche statische Member-Konstante)
digits [static]	Anzahl der radix-Ziffern, die ohne Änderung dargestellt werden können (öffentliche statische Member-Konstante)
digits10 [static]	Anzahl der Dezimalziffern, die ohne Änderung dargestellt werden können (öffentlicher statischer Member-Konstante)
min_exponent [static]	eins mehr als die kleinste negative Potenz der Basis, die ein gültiger normalisierter Gleitkommawert ist (öffentliche statische Member-Konstante)
max_exponent [static]	eins mehr als die größte ganzzahlige Potenz der Basis, die ein gültiger endlicher Gleitkommawert ist (öffentliche statische Member-Konstante)