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::string 构造函数抛出 std::bad_alloc.

[编辑] 注释

对于浮点类型，std::to_string 可能产生意外的结果，因为返回字符串中有效数字的数量可能为零，请参见示例。
返回值可能与 std::cout 默认打印的内容有很大差异，请参见示例。

std::to_string 依赖于当前的 C 本地化设置进行格式化，因此来自多个线程的并发调用 std::to_string 可能会导致部分序列化调用。
- 整数类型重载的结果不依赖于当前的 C 本地化设置，因此实现通常为了正确性和性能，在这些重载中避免访问当前的 C 本地化设置。但是，标准并没有保证这种避免行为。

(直到 C++26)

C++17 提供了 std::to_chars 作为一种更高性能的与本地化无关的替代方案。

特性测试宏	值	Std	特性
`__cpp_lib_to_string`	202306L	(C++26)	根据 std::format 重新定义 `std::to_string`

[编辑] 示例

运行此代码

#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)	将整型或浮点型值转换为字符序列 (函数) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

以空字符结尾的字符串
字节字符串
多字节字符串
宽字符串
类
basic_string
basic_string_view (C++17)
char_traits

cppreference.com

命名空间

变体

视图

操作