function template
<fstream>

std::swap (basic_fstream)

template <class charT, class traits>  void swap (basic_fstream<charT,traits>& x, basic_fstream<charT,traits>& y);
Swap file streams
Exchanges the values of the basic_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
basic_fstream objects of the same type (i.e., having both the same template parameters, charT and traits).

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