std::numeric_limits<T>::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 const int digits10;		(bis C++11)
static constexpr int digits10;		(seit C++11)

Der Wert von std::numeric_limits<T>::digits10 ist die Anzahl der Dezimalstellen, die vom Typ T ohne Veränderung dargestellt werden können, d.h. jede Zahl mit dieser Anzahl von signifikanten Dezimalstellen kann in einen Wert vom Typ T und zurück in Dezimalform umgewandelt werden, ohne Veränderung durch Rundung oder Überlauf. Für Typen mit Basis-radix ist es der Wert von digits() (digits - 1 für Gleitkommatypen) multipliziert mit \(\small \log_{10}{radix}\)log10(radix) und abgerundet.

Standard-Spezialisierungen

T	Wert von std::numeric_limits<T>::digits10
/* nicht spezialisiert */	​0​
bool	​0​
char	std::numeric_limits<char>::digits * std::log10(2)
signed char	std::numeric_limits<signed char>::digits * std::log10(2)
unsigned char	std::numeric_limits<unsigned char>::digits * std::log10(2)
wchar_t	std::numeric_limits<wchar_t>::digits * std::log10(2)
char8_t (seit C++20)	std::numeric_limits<char8_t>::digits * std::log10(2)
char16_t (seit C++11)	std::numeric_limits<char16_t>::digits * std::log10(2)
char32_t (seit C++11)	std::numeric_limits<char32_t>::digits * std::log10(2)
short	std::numeric_limits<short>::digits * std::log10(2)
unsigned short	std::numeric_limits<unsigned short>::digits * std::log10(2)
int	std::numeric_limits<int>::digits * std::log10(2)
unsigned int	std::numeric_limits<unsigned int>::digits * std::log10(2)
long	std::numeric_limits<long>::digits * std::log10(2)
unsigned long	std::numeric_limits<unsigned long>::digits * std::log10(2)
long long (seit C++11)	std::numeric_limits<long long>::digits * std::log10(2)
unsigned long long (seit C++11)	std::numeric_limits<unsigned long long>::digits * std::log10(2)
float	FLT_DIG (6 für IEEE float)
double	DBL_DIG (15 für IEEE double)
long double	LDBL_DIG (18 für 80-Bit Intel long double; 33 für IEEE quadruple)

Beispiel

Ein 8-Bit-Binärtyp kann jede zweistellige Dezimalzahl exakt darstellen, aber 3-stellige Dezimalzahlen von 256 bis 999 können nicht dargestellt werden. Der Wert von digits10 für einen 8-Bit-Typ ist 2 (8 * std::log10(2) ist 2.41)

Der Standard-32-Bit-IEEE-754-Gleitkommatyp hat einen 24-Bit-Nachkommateil (23 geschriebene Bits, ein implizites Bit), was darauf hindeuten könnte, dass er 7-stellige Dezimalzahlen darstellen kann (24 * std::log10(2) ist 7.22), aber relative Rundungsfehler sind nicht einheitlich und einige Gleitkommazahlen mit 7 Dezimalstellen überstehen die Konvertierung zu 32-Bit-Float und zurück nicht: das kleinste positive Beispiel ist 8.589973e9, was nach dem Roundtrip zu 8.589974e9 wird. Diese Rundungsfehler können nicht mehr als ein Bit in der Darstellung betragen, und digits10 wird berechnet als (24 - 1) * std::log10(2), was 6.92 ergibt. Abrunden führt zum Wert 6.

Ebenso übersteht die 16-stellige Zeichenkette 9007199254740993 keinen Text->Double->Text-Roundtrip und wird zu 9007199254740992: der 64-Bit IEEE-754-Typ double garantiert diesen Roundtrip nur für 15 Dezimalstellen.

Siehe auch

max_digits10 [statisch] (C++11)	Anzahl der Dezimalstellen, die notwendig sind, um alle Werte dieses Typs zu unterscheiden (öffentlicher statischer Member-Konstante)
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)
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)