# std::to_wstring

> C++ Atlas: `cppatlas.com/w/cpp/string/basic_string/to_wstring` | Source: https://en.cppreference.com/w/cpp/string/basic_string/to_wstring | Domain: Strings | Standards: C++11, C++26

Converts a numeric value to std::wstring.

## Official Specification Summary (cppreference)

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

Converts a numeric value to `std::wstring`.

(until C++26):

Let `buf` be an internal to the conversion functions buffer, sufficiently large to contain the result of conversion.

1) Converts a signed decimal integer to a wide string as if by `std::swprintf(buf, sz, L"%d", value)`.

2) Converts a signed decimal integer to a wide string as if by `std::swprintf(buf, sz, L"%ld", value)`.

3) Converts a signed decimal integer to a wide string as if by `std::swprintf(buf, sz, L"%lld", value)`.

4) Converts an unsigned decimal integer to a wide string as if by `std::swprintf(buf, sz, L"%u", value)`.

5) Converts an unsigned decimal integer to a wide string as if by `std::swprintf(buf, sz, L"%lu", value)`.

6) Converts an unsigned decimal integer to a wide string as if by `std::swprintf(buf, sz, L"%llu", value)`.

7,8) Converts a floating point value to a wide string as if by `std::swprintf(buf, sz, L"%f", value)`.

9) Converts a floating point value to a wide string as if by `std::swprintf(buf, sz, L"%Lf", value)`.

1-9) Converts a numeric value to a wide string as if by `std::format(L"{}", value)`. (since C++26)

### Parameters

- `value` - a numeric value to convert

### Return value

A wide string holding the converted value.

### Exceptions

May throw `std::bad_alloc` from the `std::wstring` constructor.

### Example

```cpp
#include <iostream>
#include <string>

int main()
{
    for (const double f : {23.43, 1e-9, 1e40, 1e-40, 123456789.0})
        std::wcout << "std::wcout: " << f << '\n'
                   << "to_wstring: " << std::to_wstring(f) << "\n\n";
}
```

Output:

```text
std::wcout: 23.43
to_wstring: 23.430000

std::wcout: 1e-09
to_wstring: 0.000000

std::wcout: 1e+40
to_wstring: 10000000000000000303786028427003666890752.000000

std::wcout: 1e-40
to_wstring: 0.000000

std::wcout: 1.23457e+08
to_wstring: 123456789.000000
```

### See also

- [`to_string`](https://en.cppreference.com/w/cpp/string/basic_string/to_string) (C++11): converts an integral or floating-point value to `string` (function)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/basic_string/to_wstring (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.