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 <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++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Ranges ライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行処理サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
技術仕様書
シンボル索引
外部ライブラリ

クラス
basic_string
basic_string_view (C++17)
char_traits

to_wstring (C++11)	整数または浮動小数点値を `wstring` に変換する (関数)
stoul stoull (C++11) (C++11)	文字列を符号なし整数に変換する (関数)
stoi stol stoll (C++11) (C++11) (C++11)	文字列を符号付き整数に変換する (関数)
stof stod stold (C++11) (C++11) (C++11)	文字列を浮動小数点値に変換する (関数)
to_chars (C++17)	整数または浮動小数点値を文字シーケンスに変換する (関数)

ja.cppreference.net

Namespaces

Variants

std::to_string

目次

パラメータ

戻り値

例外

注記

例

関連項目