std::numeric_limits<T>::max_digits10

static constexpr int max_digits10

(начиная с C++11)

Значение std::numeric_limits<T>::max_digits10 — это количество десятичных цифр, необходимых для однозначного представления всех различных значений типа T, например, при сериализации/десериализации в текстовом формате. Эта константа имеет смысл для всех типов с плавающей точкой.

Стандартные специализации

`T`	Значение `std::numeric_limits<T>::max_digits10`
/* non-specialized */	`0`
bool	`0`
char	`0`
signedchar	`0`
unsignedchar	`0`
wchar_t	`0`
char8_t (начиная с C++20)	`0`
char16_t	`0`
char32_t	`0`
short	`0`
unsignedshort	`0`
int	`0`
unsignedint	`0`
long	`0`
unsignedlong	`0`
longlong	`0`
unsignedlonglong	`0`
float	`FLT_DECIMAL_DIG` или `std::ceil(std::numeric_limits<float>::digits * std::log10(2) + 1)`
double	`DBL_DECIMAL_DIG` или `std::ceil(std::numeric_limits<double>::digits * std::log10(2) + 1)`
longdouble	`DECIMAL_DIG` или `LDBL_DECIMAL_DIG` или `std::ceil(std::numeric_limits<long double>::digits * std::log10(2) + 1)`

Примечания

В отличие от большинства математических операций, преобразование значения с плавающей точкой в текст и обратно является точным, если использовано не менее max_digits10 (9 для float, 17 для double): гарантируется получение того же значения с плавающей точкой, даже если промежуточное текстовое представление не является точным. Для представления точного значения float в десятичной записи может потребоваться более ста десятичных цифр.

Пример

#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);
}

Вывод:

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

См. также

radix [static]	основание системы счисления, используемое представлением данного типа (общедоступная статическая константа-член)
digits [static]	количество двоичных `radix` цифр, которые могут быть представлены без изменений (общедоступная статическая константа-член)
digits10 [static]	количество десятичных цифр, которые могут быть представлены без изменений (общедоступная статическая константа-член)
min_exponent [static]	на единицу больше наименьшей отрицательной степени основания системы счисления, являющейся допустимым нормализованным значением с плавающей точкой (общедоступная статическая константа-член)
max_exponent [static]	на единицу больше наибольшей целой степени основания системы счисления, являющейся допустимым конечным значением с плавающей точкой (общедоступная статическая константа-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/types/numeric_limits/max_digits10