std::to_string

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Technical Specifications

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

char_traits

 

std::basic_string

Member functions basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Element access basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str Iterators 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) Capacity 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)

Operations 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::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Search 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 Constants basic_string::npos

Non-member functions operator+ operator==operator!=operator<operator>operator<=operator>= swap(std::basic_string) operator<<operator>> getline stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11) stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Helper classes hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string> (C++11)(C++11)(C++11)(C++11)

 

Defined in header <string>
std::string to_string( int value );	(1)	(since C++11)
std::string to_string( long value );	(2)	(since C++11)
std::string to_string( long long value );	(3)	(since C++11)
std::string to_string( unsigned value );	(4)	(since C++11)
std::string to_string( unsigned long value );	(5)	(since C++11)
std::string to_string( unsigned long long value );	(6)	(since C++11)
std::string to_string( float value );	(7)	(since C++11)
std::string to_string( double value );	(8)	(since C++11)
std::string to_string( long double value );	(9)	(since C++11)

Converts a numeric value to std::string.

1) Converts a signed decimal integer to a string with the same content as what std::sprintf(buf, "%d", value) would produce for sufficiently large buf.

2) Converts a signed decimal integer to a string with the same content as what std::sprintf(buf, "%ld", value) would produce for sufficiently large buf.

3) Converts a signed decimal integer to a string with the same content as what std::sprintf(buf, "%lld", value) would produce for sufficiently large buf.

4) Converts an unsigned decimal integer to a string with the same content as what std::sprintf(buf, "%u", value) would produce for sufficiently large buf.

5) Converts an unsigned decimal integer to a string with the same content as what std::sprintf(buf, "%lu", value) would produce for sufficiently large buf.

6) Converts an unsigned decimal integer to a string with the same content as what std::sprintf(buf, "%llu", value) would produce for sufficiently large buf.

7,8) Converts a floating point value to a string with the same content as what std::sprintf(buf, "%f", value) would produce for sufficiently large buf.

9) Converts a floating point value to a string with the same content as what std::sprintf(buf, "%Lf", value) would produce for sufficiently large buf.

Parameters

value

-

a numeric value to convert

Return value

a string holding the converted value

Notes

std::to_string may yield unexpected results when used with floating point types and the return values may be substantially different from what std::cout would print, see the example.

Example

Run this code

#include <iostream>
#include <string>
 
int main() 
{
    double f = 23.43;
    double f2 = 1e-9;
    double f3 = 1e40;
    double f4 = 1e-40;
    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::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';
}

Output:

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

See also

to_wstring (C++11)	converts an integral or floating point value to wstring (function)
stoulstoull (C++11)(C++11)	converts a string to an unsigned integer (function)
stoistolstoll (C++11)(C++11)(C++11)	converts a string to a signed integer (function)
stofstodstold (C++11)(C++11)(C++11)	converts a string to a floating point value (function)