std::to_string

Объявлено в заголовочном файле `<string>`
std::string to_string( int value );	(1)	(начиная с C++11)
std::string to_string( long value );	(2)	(начиная с C++11)
std::string to_string( long long value );	(3)	(начиная с C++11)
std::string to_string( unsigned value );	(4)	(начиная с C++11)
std::string to_string( unsigned long value );	(5)	(начиная с C++11)
std::string to_string( unsigned long long value );	(6)	(начиная с C++11)
std::string to_string( float value );	(7)	(начиная с C++11)
std::string to_string( double value );	(8)	(начиная с C++11)
std::string to_string( long double value );	(9)	(начиная с C++11)

Преобразует числовое значение в std::string.

Пусть buf — внутренний буфер функций преобразования, достаточно большой для хранения результата преобразования.

1) Преобразует целое число со знаком в строку, как если бы выполнялся вызов std::sprintf(buf, "%d", value). 2) Преобразует целое число со знаком в строку, как если бы выполнялся вызов std::sprintf(buf, "%ld", value). 3) Преобразует целое число со знаком в строку, как если бы выполнялся вызов std::sprintf(buf, "%lld", value). 4) Преобразует целое число без знака в строку, как если бы выполнялся вызов std::sprintf(buf, "%u", value). 5) Преобразует целое число без знака в строку, как если бы выполнялся вызов std::sprintf(buf, "%lu", value). 6) Преобразует целое число без знака в строку, как если бы выполнялся вызов std::sprintf(buf, "%llu", value). 7,8) Преобразует значение с плавающей точкой в строку, как если бы выполнялся вызов std::sprintf(buf, "%f", value). 9) Преобразует значение с плавающей точкой в строку, как если бы выполнялся вызов std::sprintf(buf, "%Lf", value).

(до C++26)

1-9) Преобразует числовое значение в строку, как если бы выполнялся вызов std::format("{}", value). (начиная с C++26)

Параметры

value

числовое значение для преобразования

Возвращаемое значение

Строка, содержащая преобразованное значение.

Исключения

Может выбросить std::bad_alloc из конструктора std::string.

Примечания

Для типов с плавающей точкой std::to_string может приводить к неожиданным результатам, поскольку количество значащих цифр в возвращаемой строке может быть равно нулю; см. пример.
Возвращаемое значение может значительно отличаться от результата, который по умолчанию выводит std::cout; см. пример.

std::to_string использует текущую локаль C для форматирования, поэтому одновременные вызовы std::to_string из нескольких потоков могут привести к частичной сериализации вызовов.
- Результаты перегрузок для целочисленных типов не зависят от текущей локали C, поэтому реализации обычно избегают обращения к текущей локали C в этих перегрузках ради корректности и производительности. Однако стандарт не гарантирует такого поведения.

(до C++26)

C++17 предоставляет std::to_chars — более производительную альтернативу, не зависящую от локали.

Макрос проверки поддержки возможности	Значение	Стандарт	Возможность
`__cpp_lib_to_string`	`202306L`	(C++26)	Переопределение `std::to_string` через `std::format`

Пример

#include <cstdio>
#include <format>
#include <initializer_list>
#include <iostream>
#include <string>

#if __cpp_lib_to_string >= 202306L
constexpr auto revision() { return " (post C++26)"; }
#else
constexpr auto revision() { return " (pre C++26)"; }
#endif

int main()
{
    for (const double f : {1.23456789555555, 23.43, 1e-9, 1e40, 1e-40, 123456789.0})
    {
        std::cout << "to_string:\t" << std::to_string(f) << revision() << '\n';

        // Before C++26, the output of std::to_string matches std::printf.
        std::printf("printf:\t\t%f\n", f);

        // As of C++26, the output of std::to_string matches std::format.
        std::cout << std::format("format:\t\t{}\n", f);

        std::cout << "std::cout:\t" << f << "\n\n";
    }
}

Возможный вывод:

to_string:      1.234568 (pre C++26)
printf:         1.234568
format:         1.23456789555555
std::cout:      1.23457

to_string:      23.430000 (pre C++26)
printf:         23.430000
format:         23.43
std::cout:      23.43

to_string:      0.000000 (pre C++26)
printf:         0.000000
format:         1e-09
std::cout:      1e-09

to_string:      10000000000000000303786028427003666890752.000000 (pre C++26)
printf:         10000000000000000303786028427003666890752.000000
format:         1e+40
std::cout:      1e+40

to_string:      0.000000 (pre C++26)
printf:         0.000000
format:         1e-40
std::cout:      1e-40

to_string:      123456789.000000 (pre C++26)
printf:         123456789.000000
format:         123456789
std::cout:      1.23457e+08

См. также

to_wstring (C++11)	преобразует целочисленное значение или значение с плавающей точкой в `wstring` (функция)
stoulstoull (C++11)(C++11)	преобразует строку в целое число без знака (функция)
stoistolstoll (C++11)(C++11)(C++11)	преобразует строку в целое число со знаком (функция)
stofstodstold (C++11)(C++11)(C++11)	преобразует строку в значение с плавающей точкой (функция)
to_chars (C++17)	преобразует целочисленное значение или значение с плавающей точкой в последовательность символов (функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/basic_string/to_string