std::to_string
Начиная с ru.cppreference.net
| Определён в заголовке <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.
|
Пусть 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выводит по умолчанию, см. пример.
|
(до 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)
|
преобразует целочисленное значение или значение с плавающей точкой в последовательность символов
(функция) |