function template
<fstream>

std::swap (fstream)

void swap (fstream& x, fstream& y);
Swap file streams
Exchanges the values of the fstream objects x and y.

This is an overload of the generic algorithm swap that behaves as if x.swap(y) was called.

Parameters

x,y
fstream objects to swap.

Return value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// swapping fstream objects
#include <fstream>      // std::fstream

int main () {
  std::fstream foo;
  std::fstream bar ("test.txt");

  swap(foo,bar);

  foo << "lorem ipsum";

  foo.close();

  return 0;
}

Data races

Both objects, x and y, are modified.

Exception safety

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

See also