swap


function
<string>
void swap ( string& lhs, string& rhs);

Swap contents of two strings

Swaps the contents of the string objects lhs and rhs, such that after the call to this function, the contents of rhs are those which were in lhs before the call, and the contents of lhs are those which were in rhs.

Notice that string objects implement a member function also called swap; In fact, this global function effectively calls:
lhs.swap(rhs);

Parameters

lhs
a string object to be swapped.
rhs
the other string object to be swapped.


Return value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// swap strings
#include <iostream>
#include <string>
using namespace std;

main ()
{
  string buyer ("money");
  string seller ("goods");

  cout << "Before swap, buyer has " << buyer;
  cout << " and seller has " << seller << endl;

  swap (buyer,seller);

  cout << " After swap, buyer has " << buyer;
  cout << " and seller has " << seller << endl;

  return 0;
}


Output:
Before swap, buyer has money and seller has goods
 After swap, buyer has goods and seller has money


Basic template declaration

1
2
3
template<class charT, chass traits, class Allocator>
  void swap ( basic_string<charT,traits,Allocator>& lhs,
              basic_string<charT,traits,Allocator>& rhs);


See also