public member function
<sstream>

std::stringstream::swap

void swap (stringstream& x);
Swap internals
Exchanges all internal data between x and *this.

Internally, the function calls iostream::swap and then calls the member swap of the associated stringbuf object.

Parameters

x
Another stringstream object.

Return Value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// swapping stringstream objects
#include <string>       // std::string
#include <iostream>     // std::cout
#include <sstream>      // std::stringstream

int main () {

  std::stringstream foo;
  std::stringstream bar;

  foo << 100;
  bar << 200;

  foo.swap(bar);

  int val;

  foo >> val; std::cout << "foo: " << val << '\n';
  bar >> val; std::cout << "bar: " << val << '\n';

  return 0;
}

Output:
foo: 200
bar: 100


Data races

Modifies both stream objects (*this and x).

Exception safety

No-throw guarantee: this member function never throws exceptions.

See also