◐ Shell
clean mode source ↗

std::to_string - cppreference.com

来自cppreference.com

在标头 <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 起)

参数

返回值

包含转换后数值的字符串

异常

可能从 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。

功能特性测试宏 值 标准 功能特性
__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 " (C++26 后)"; }
#else
constexpr auto revision() { return " (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 (C++26 前)
printf:         1.234568
format:         1.23456789555555
std::cout:      1.23457

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

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

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

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

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

参阅