Namespaces
Variants

std:: to_string

From cppreference.net
C++
Strings library
std::basic_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';
        // До C++26 вывод std::to_string соответствует std::printf.
        std::printf("printf:\t\t%f\n", f);
        // Начиная с C++26 вывод std::to_string соответствует 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

Смотрите также

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