reverse (STL Samples)

Illustrates how to use the reverse Standard Template Library (STL) function in Visual C++.

template<class BidirectionalIterator> inline
   void reverse(
      BidirectionalIterator First,
      BidirectionalIterator Last
   )

Remarks

The reverse algorithm reverses the order of the elements in the range [First, Last).

Example

// reverse.cpp
// compile with: /EHsc
// Illustrates how to use the reverse function.
//
// Functions:
//    reverse - Reverse the items in a sequence.

// disable warning C4786: symbol greater than 255 character,
// okay to ignore
#pragma warning(disable: 4786)

#include <iostream>
#include <vector>
#include <string>
#include <algorithm>
#include <functional>

using namespace std;


int main()
{
   const int VECTOR_SIZE = 8;

   // Define a template class vector of strings
   typedef vector<string > StrVector;

   //Define an iterator for template class vector of strings
   typedef StrVector::iterator StrVectorIt;

   StrVector Tongue_Twister(VECTOR_SIZE);
   StrVectorIt start, end, it;

   // location of first element of Tongue_Twister
   start = Tongue_Twister.begin();

   // one past the location last element of Tongue_Twister
   end = Tongue_Twister.end();

   //Initialize vector Tongue_Twister
   Tongue_Twister[0] = "she";
   Tongue_Twister[1] = "sells";
   Tongue_Twister[2] = "sea";
   Tongue_Twister[3] = "shells";
   Tongue_Twister[4] = "by";
   Tongue_Twister[5] = "the";
   Tongue_Twister[6] = "sea";
   Tongue_Twister[7] = "shore";

   cout << "Before calling reverse" << endl;

   // print content of Tongue_Twister
   cout << "Try this Tongue Twister:";
   for (it = start; it != end; it++)
      cout << " " << *it;
   cout << endl;

   // reverse the items in the vector Tongue_Twister
   reverse(start, end);

   cout << "After calling reverse" << endl;

   // print content of Tongue_Twister
   cout << "Now try the reversed Tongue Twister:";
   for (it = start; it != end; it++)
      cout << " " << *it;
}

Output

Before calling reverse
Try this Tongue Twister: she sells sea shells by the sea shore
After calling reverse
Now try the reversed Tongue Twister: shore sea the by shells sea sells she

Requirements

Header: <algorithm>

See Also

Concepts

Standard Template Library Samples