std::to_string

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ(C++17)

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

メンバ関数 basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator 要素アクセス basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) イテレータ basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) 容量 basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

操作 basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap 検索 basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of 定数 basic_string::npos

非メンバ関数 operator+ swap(std::basic_string) operator""s (C++14) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) 入出力 operator<<operator>> getline 比較 operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20) 数値変換 (C++11) stoistolstoll stoulstoull stofstodstold to_string to_wstring ヘルパークラス hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string> (C++11)(C++11)(C++11)(C++11)(C++20) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string> (C++20)(C++20)(C++20)(C++20)(C++20) 推定ガイド(C++17)

 

ヘッダ <string> で定義
std::string to_string(int value );	(1)	(C++11以上)
std::string to_string(long value );	(2)	(C++11以上)
std::string to_string(longlong value );	(3)	(C++11以上)
std::string to_string(unsigned value );	(4)	(C++11以上)
std::string to_string(unsignedlong value );	(5)	(C++11以上)
std::string to_string(unsignedlonglong 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(longdouble value );	(9)	(C++11以上)

数値を std::string に変換します。

1) 符号付き整数を、十分大きな buf に対して std::sprintf(buf, "%d", value) が生成するのと同じ内容を持つ文字列に変換します。

2) 符号付き整数を、十分大きな buf に対して std::sprintf(buf, "%ld", value) が生成するのと同じ内容を持つ文字列に変換します。

3) 符号付き整数を、十分大きな buf に対して std::sprintf(buf, "%lld", value) が生成するのと同じ内容を持つ文字列に変換します。

4) 符号なし整数を、十分大きな buf に対して std::sprintf(buf, "%u", value) が生成するのと同じ内容を持つ文字列に変換します。

5) 符号なし整数を、十分大きな buf に対して std::sprintf(buf, "%lu", value) が生成するのと同じ内容を持つ文字列に変換します。

6) 符号なし整数を、十分大きな buf に対して std::sprintf(buf, "%llu", value) が生成するのと同じ内容を持つ文字列に変換します。

7,8) 浮動小数点値を、十分大きな buf に対して std::sprintf(buf, "%f", value) が生成するのと同じ内容を持つ文字列に変換します。

9) 浮動小数点値を、十分大きな buf に対して std::sprintf(buf, "%Lf", value) が生成するのと同じ内容を持つ文字列に変換します。

引数

value

-

変換する数値

戻り値

変換された値を保持する文字列。

例外

std::string のコンストラクタから std::bad_alloc が投げられるかもしれません。

ノート

• 浮動小数点型の場合、std::to_string は有効桁数がゼロであるような予期しない結果を生成するかもしれません。 例を参照してください。
• 戻り値は std::cout がデフォルトで表示する内容と大きく異なるかもしれません。 例を参照してください。
• std::to_string は書式化目的のために現在のロケールを頼ります。 そのため複数のスレッドからの std::to_string の並行的な呼び出しは、呼び出しを部分的に直列化するかもしれません。 C++17 では、より高性能なロケールに依存しない代替品として std::to_chars が提供されます。

例

Run this code

#include <iostream>#include <string>   int main(){double f =23.43;double f2 =1e-9;double f3 =1e40;double f4 =1e-40;double f5 =123456789;std::string f_str = std::to_string(f);std::string f_str2 = std::to_string(f2);// Note: returns "0.000000"std::string f_str3 = std::to_string(f3);// Note: Does not return "1e+40".std::string f_str4 = std::to_string(f4);// Note: returns "0.000000"std::string f_str5 = std::to_string(f5);std::cout<<"std::cout: "<< f <<'\n'<<"to_string: "<< f_str <<"\n\n"<<"std::cout: "<< f2 <<'\n'<<"to_string: "<< f_str2 <<"\n\n"<<"std::cout: "<< f3 <<'\n'<<"to_string: "<< f_str3 <<"\n\n"<<"std::cout: "<< f4 <<'\n'<<"to_string: "<< f_str4 <<"\n\n"<<"std::cout: "<< f5 <<'\n'<<"to_string: "<< f_str5 <<'\n';}

出力:

std::cout: 23.43 to_string: 23.430000   std::cout: 1e-09 to_string: 0.000000   std::cout: 1e+40 to_string: 10000000000000000303786028427003666890752.000000   std::cout: 1e-40 to_string: 0.000000   std::cout: 1.23457e+08 to_string: 123456789.000000

関連項目

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)	整数値または浮動小数点値を文字シーケンスに変換します (関数)