Standard C++ LibraryCopyright 1996, Rogue Wave Software, Inc.

NAME

  iter_swap  - Exchange values pointed at in two locations

SYNOPSIS

  #include <algorithm>

  template <class ForwardIterator1, class ForwardIterator2>
  void iter_swap (ForwardIterator1, ForwardIterator2);

DESCRIPTION

  The iter_swap algorithm exchanges the values pointed at by the two
  iterators a and b.

EXAMPLE

  #include <vector>
  #include <algorithm>
  #include <iostream.h>

  int main ()
   {
    int d1[] = {6, 7, 8, 9, 10, 1, 2, 3, 4, 5};
     //
     // Set up a vector.
     //
    vector<int> v(d1+0, d1+10);
     //
     // Output original vector.
     //
    cout << "For the vector: ";
    copy(v.begin(), v.end(), ostream_iterator<int,char>(cout," "));
     //
     // Swap the first five elements with the last five elements.
     //
    swap_ranges(v.begin(), v.begin()+5, v.begin()+5);
     //
     // Output result.
     //
    cout << endl << endl
          << "Swapping the first 5 elements with the last 5 gives: "
          << endl << "     ";
    copy(v.begin(), v.end(), ostream_iterator<int,char>(cout," "));
     //
     // Now an example of iter_swap -- swap first and last elements.
     //
     iter_swap(v.begin(), v.end()-1);
     //
     // Output result.
     //
    cout << endl << endl
          << "Swapping the first and last elements gives: "
          << endl << "     ";
    copy(v.begin(), v.end(), ostream_iterator<int,char>(cout," "));
    cout << endl;

    return 0;
   }

  Output :
  For the vector: 6 7 8 9 10 1 2 3 4 5
  Swapping the first five elements with the last five gives:
      1 2 3 4 5 6 7 8 9 10
  Swapping the first and last elements gives:
      10 2 3 4 5 6 7 8 9 1

WARNING

  If your compiler does not support default template parameters, then you
  will need to always supply the Allocator template argument.  For instance,
  you'll have to write :

  vector<int, allocator<int> >

  instead of :

  vector<int>

SEE ALSO

  Iterators, swap, swap_ranges

STANDARDS CONFORMANCE

  ANSI X3J16/ISO WG21 Joint C++ Committee



privacy and legal statement