std::swap(s...tringstream)(3)

💅 std::swap(std::basic_istringstream) 💅

okay bestie so this page lives in the C++ Standard Library manual (yes, the whole std::swap(s...tringstream)(3) situation) and it's honestly a tiny little glow-up of a function. let me break it down 🫶

---

✨ NAME ✨

std::swap(std::basic_istringstream) — literally what it says on the tin: the swap for std::basic_istringstream. no cap, that's the whole name, twice, because the manpage said it twice and I would never gatekeep a single character from you 💖

---

🌸 Synopsis 🌸

okay so, this one's Defined in header <sstream> — that's where it lives, don't forget to include it or nothing works, periodt.

template< class CharT, class Traits, class Alloc >

void swap( std::basic_istringstream<CharT,Traits,Alloc>& lhs,
(since C++11)

           std::basic_istringstream<CharT,Traits,Alloc>& rhs );

so what does it do? it Overloads the std::swap algorithm for std::basic_istringstream. — like, it's the special swap just for these stream girls 👑

it Exchanges the state of lhs with that of rhs. — effectively calls lhs.swap(rhs). that's it, that's the vibe. two streams trade states, everyone goes home happy ✨

quick note bestie: this overload is (since C++11) — if you're time-traveling to C++03, this one's not there for you 😭

---

🎀 Parameters 🎀

• lhs, rhs — streams whose state to swap — yeah, just the two streams swapping their whole situation. give them a minute 🙈

---

🦋 Return value 🦋

(none) — nothing comes back. void behavior, zero notes, it just does the thing 💅

---

⭐ Exceptions ⭐

May throw implementation-defined exceptions. — so like, it might throw, and what exactly it throws depends on your implementation. no promises, no cap, just vibes 🔥

---

🌈 Example 🌈

big yikes: This section is incomplete

Reason: no example 😭😭 the manpage really said "figure it out bestie" — so yeah, there's no example here. not me crying over an empty example section fr fr 💀

---

💜 See also 💜

• swap — swaps two string streams, and it's a (C++11) public member function. that's the member-function bestie to this free-function one 🫶

---

👑 Category 👑

• * Todo no example

like, the category itself is calling out the missing example. it's giving self-aware 😭

---

okay that's the whole page, you ate that, no crumbs left 🍓 this iconic little doc came from http://cppreference.com, dated 2024.06.10, and it's filed under std::swap(s...tringstream)(3) — go forth and swap those stream states, bestie 💖✨🎀