std::to_wstring(3)

💖 std::to_wstring(3) 💖

okay bestie, welcome to std::to_wstring from the C++ Standard Libary — yes, that's their spelling, not mine 💀. This whole page is about turning numbers into wide strings, and it's honestly giving “small utility, main character energy” ✨. Let's go.

---

✨ NAME ✨

std::to_wstring - std::to_wstring

---

🌸 SYNOPSIS 🌸

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. That's the vibe. 💅

Okay so let buf be an internal to the conversion functions buffer, sufficiently large to contain the result of conversion. Like, there's a buffer, it's big enough, we don't gotta worry about it. 🫶

• 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 (until C++26) 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) — (since C++26) Converts a numeric value to a wide string as if by std::format(L"{}", value).

---

💖 PARAMETERS 💖

• value — a numeric value to convert.

---

🎀 RETURN VALUE 🎀

A wide string holding the converted value. Periodt. 🎀

---

🦋 EXCEPTIONS 🦋

May throw std::bad_alloc from the std::wstring constructor. So yeah, allocate responsibly, bestie 😭.

---

🍓 EXAMPLE 🍓

// Run this code

#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: 🌈

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 — converts an integral or floating-point value to string (C++11) (function).

---

mwah 💋 — source/version: http://cppreference.com · date: 2024.06.10 · page: std::to_wstring(3). slay and goodbye 🦋✨