Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::basic_ostream::swap(3)   C++ Standard Libary  std::basic_ostream::swap(3)

NAME
       std::basic_ostream::swap	- std::basic_ostream::swap

Synopsis
	  protected:			  (since C++11)
	  void swap(basic_ostream& rhs);

	  Calls	 basic_ios::swap(rhs)  to  swap	 all  data members of the base
       class, except for
	  rdbuf(), between *this and rhs. This swap function is	protected:  it
       is called by the
	  swap functions of the	swappable output stream	classes	std::basic_of-
       stream and
	  std::basic_ostringstream, which know how to correctly	swap the asso-
       ciated
	  streambuffers.

Parameters
	  rhs -	a basic_ostream	of the same type to swap with

Example
       // Run this code

	#include <sstream>
	#include <iostream>
	#include <utility>
	int main()
	{
	    std::ostringstream s1("hello");
	    std::ostringstream s2("bye");

	    s1.swap(s2); // OK,	ostringstream has a public swap()
	    std::swap(s1, s2); // OK, calls s1.swap(s2)

	//  std::cout.swap(s2);	// ERROR: swap is a protected member

	    std::cout << s1.str() << '\n';
	}

Output:
	hello

http://cppreference.com		  2022.07.31	   std::basic_ostream::swap(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::wostream::swap&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help