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 <iostream>
#include <string>
 
int main()
{
    for (const double f : {23.43, 1e-9, 1e40, 1e-40, 123456789.0})
        std::cout << "std::cout: " << f << '\n'
                  << "to_string: " << std::to_string(f) << "\n\n";
}

Вывод:

std::cout: 23.43
to_string: 23.430000
 
std::cout: 1e-09
to_string: 0.000000
 
std::cout: 1e+40
to_string: 10000000000000000303786028427003666890752.000000
 
std::cout: 1e-40
to_string: 0.000000
 
std::cout: 1.23457e+08
to_string: 123456789.000000

См. также

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/w/cpp/string/basic_string/to_string