std::basic_...f::operator=(3)

🌸 NAME 🌸

okay so this page is std::basic_...f::operator=(3), straight from the C++ Standard Libary manual, and it's all about std::basic_stringbuf::operator=. The name line is literally std::basic_stringbuf::operator= — std::basic_stringbuf::operator=. It's the assignment operator for std::basic_stringbuf, and it's giving “move it, but don't copy it” energy 💅✨

✨ Synopsis ✨

two overloads, bestie. one is the move assignment (since C++11), and the other is deleted. here's the exact shape:

std::basic_stringbuf& operator=( std::basic_stringbuf&& rhs );
(1) (since C++11)
std::basic_stringbuf& operator=( const std::basic_stringbuf& rhs )
(2)
= delete;

1. Move assignment operator: moves the contents of rhs into *this. After the move, *this has the associated string, the open mode, the locale, and all other state formerly held by rhs. The six pointers of std::basic_streambuf in *this are guaranteed to be different from the corresponding pointers in the moved-from rhs unless null. no cap, that's the whole guarantee 🫶
2. The copy assignment operator is deleted; basic_stringbuf is not CopyAssignable. copying is not invited to the function, bestie 💀

🎀 Parameters 🎀

• rhs — another basic_stringbuf that will be moved from. that's the whole param list, and yes it's doing exactly what it says on the tin 🎀

💖 Return value 💖

*this. that's it. iconic behavior, honestly 👑

🧚 Example 🧚

there's a little // Run this code vibe in the original, so here's the exact code:

#include <iostream>
#include <sstream>
#include <string>

int main()
{
    std::istringstream one("one");
    std::ostringstream two("two");

    std::cout << "Before move, one = \"" << one.str() << '"'
              << " two = \"" << two.str() << "\"\n";

    *one.rdbuf() = std::move(*two.rdbuf());

    std::cout << "After move, one = \"" << one.str() << '"'
              << " two = \"" << two.str() << "\"\n";
}

Output:

Before move, one = "one" two = "two"
After move, one = "two" two = ""

the way that move just ate and left two empty — we love to see it ✨

👀 See also 👀

• constructor — constructs a basic_stringbuf object (public member function). lowkey the prequel, and we're obsessed 🦋

💖 source: http://cppreference.com · version/date: 2024.06.10 · page footer: std::basic_...f::operator=(3) — bye bestie, mwah! 🫶✨