GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::to_string - cpprefjp C++日本語リファレンス

最終更新日時: 2026年09月11日 13時06分31秒 (JST)
Akira Takahashi が更新

function

std::to_string(C++11)

namespace std {
  string to_string(int val);                          // (1) C++11
  constexpr string to_string(int val);                // (1) C++26

  string to_string(unsigned int val);                 // (2) C++11
  constexpr string to_string(unsigned int val);       // (2) C++26

  string to_string(long val);                         // (3) C++11
  constexpr string to_string(long val);               // (3) C++26

  string to_string(unsigned long val);                // (4) C++11
  constexpr string to_string(unsigned long val);      // (4) C++26

  string to_string(long long val);                    // (5) C++11
  constexpr string to_string(long long val);          // (5) C++26

  string to_string(unsigned long long val);           // (6) C++11
  constexpr string to_string(unsigned long long val); // (6) C++26

  string to_string(float val);                        // (7) C++11
  string to_string(double val);                       // (8) C++11
  string to_string(long double val);                  // (9) C++11
}

概要

数値valをstring型文字列に変換する。

(1) : int型の値をstring型に変換する
(2) : unsigned int型の値をstring型に変換する
(3) : long型の値をstring型に変換する
(4) : unsigned long型の値をstring型に変換する
(5) : long long型の値をstring型に変換する
(6) : unsigned long long型の値をstring型に変換する
(7) : float型の値をstring型に変換する
(8) : double型の値をstring型に変換する
(9) : long double型の値をstring型に変換する

戻り値

C++11まで各数値型に対して、sprintf(buf, fmt, val)によって生成された文字列のstringオブジェクトを返す。使用されるバッファサイズは未規定。

各型で使用されるフォーマットは以下のようになる：

型フォーマット

int "%d"

unsigned int "%u"

long "%ld"

unsigned long "%lu"

long long "%lld"

unsigned long long "%llu"

float "%f"

double "%f"

long double "%Lf"
C++26から
```
return format("{}", val);
```

例

#include <iostream>
#include <string>

int main()
{
  std::string s1 = std::to_string(123);
  std::cout << s1 << std::endl;

  std::string s2 = std::to_string(3.14);
  std::cout << s2 << std::endl;
}

出力

123
3.140000

実装例

#include <cstdio>
#include <string>
#include <limits>

std::string to_string(int val)
{
  char buffer[std::numeric_limits<int>::digits10 + 1
          + 2]; // '-' + '\0'
  std::sprintf(buffer, "%d", val);
  return buffer;
}

std::string to_string(unsigned int val)
{
  char buffer[std::numeric_limits<unsigned int>::digits10 + 1
          + 1]; // '\0'
  std::sprintf(buffer, "%u", val);
  return buffer;
}

std::string to_string(long val)
{
  char buffer[std::numeric_limits<long>::digits10 + 1
          + 2]; // '-' + '\0'
  std::sprintf(buffer, "%ld", val);
  return buffer;
}

std::string to_string(unsigned long val)
{
  char buffer[std::numeric_limits<unsigned long>::digits10 + 1
          + 1]; // '\0'
  std::sprintf(buffer, "%lu", val);
  return buffer;
}

std::string to_string(long long int val)
{
  char buffer[std::numeric_limits<long long int>::digits10 + 1
          + 2]; // '-' + '\0'
  std::sprintf(buffer, "%lld", val);
  return buffer;
}

std::string to_string(unsigned long long int val)
{
  char buffer[std::numeric_limits<unsigned long long int>::digits10 + 1
          + 1]; // '\0'
  std::sprintf(buffer, "%llu", val);
  return buffer;
}

std::string to_string(float val)
{
  char buffer[std::numeric_limits<float>::max_exponent10 + 1
          + 6   // fixed precision (printf's default)
          + 3]; // '-' + '.' + '\0'
  std::sprintf(buffer, "%f", val);
  return buffer;
}

std::string to_string(double val)
{
  char buffer[std::numeric_limits<double>::max_exponent10 + 1
          + 6   // fixed precision (printf's default)
          + 3]; // '-' + '.' + '\0'
  std::sprintf(buffer, "%f", val);
  return buffer;
}

std::string to_string(long double val)
{
  char buffer[std::numeric_limits<long double>::max_exponent10 + 1
          + 6   // fixed precision (printf's default)
          + 3]; // '-' + '.' + '\0'
  std::sprintf(buffer, "%Lf", val);
  return buffer;
}

バージョン

言語

C++11

処理系

Clang: 3.0 ✅
GCC: 4.5.4 ✅
Visual C++: 2010 ✅, 2012 ✅, 2013 ✅, 2015 ✅, 2017 ✅
- 2010は、不完全な実装。以下の型のみ多重定義されている。
  - long long
  - unsigned long long
  - long double

参照

N2408 Simple Numeric Access Revision 2
P2587R3 to_string or not to_string
- C++26からsprintfベースの仕様をやめてstd::format()ベースの仕様になった
P3391R2 constexpr std::format
- C++26から整数バージョンがconstexprに対応した
LWG Issue 1261. Insufficent overloads for to_string / to_wstring
- C++11で、int/unsigned/long/unsigned long/float/doubleを受け取るオーバーロードが追加された。より大きな型のオーバーロードしかないと、変換が曖昧になったり意図しない拡張が起きたりするため
LWG Issue 4531. Should there be a feature-test macro update for constexpr std::to_(w)string?
- この関数のconstexpr対応を反映するために__cpp_lib_constexpr_stringが202511Lに更新された。このIssueは規格としてはC++29のワーキングドラフトへ適用されたが、C++26で追加された機能に対する修正であるため、C++26へ遡及して適用される

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.

GeezerVison

std::to_string(C++11)

概要

戻り値

例

出力

実装例

バージョン

言語

処理系

関連項目

参照