Microsoft KB Archive/158258

= How to use the reverse_copy STL function in Visual C++ =

Article ID: 158258

Article Last Modified on 1/10/2006

-

APPLIES TO

 The Standard C++ Library, when used with:  Microsoft Visual C++ 4.2 Enterprise Edition

 Microsoft Visual C++ 5.0 Enterprise Edition

 Microsoft Visual C++ 6.0 Enterprise Edition

 Microsoft Visual C++ 4.2 Professional Edition</li></ul>

 Microsoft Visual C++ 5.0 Professional Edition</li></ul>

 Microsoft Visual C++ 6.0 Professional Edition</li></ul>

 Microsoft Visual C++ 6.0 Standard Edition</li></ul>

 Microsoft Visual C++ 2005 Express Edition</li></ul>

 Microsoft Visual C++ .NET 2003 Standard Edition</li></ul>

 Microsoft Visual C++ .NET 2002 Standard Edition</li></ul> </li></ul>

-

<div class="notice_section">

This article was previously published under Q158258

<div class="notice_section">

Note Microsoft Visual C++ .NET 2002 and Microsoft Visual C++ .NET 2003 support both the managed code model that is provided by the Microsoft .NET Framework and the unmanaged native Microsoft Windows code model. The information in this article applies only to unmanaged Visual C++ code. Microsoft Visual C++ 2005 supports both the managed code model that is provided by the Microsoft .NET Framework and the unmanaged native Microsoft Windows code model.

<div class="summary_section">

SUMMARY
The sample code below illustrates how to use the reverse_copy STL function in Visual C++.

<div class="moreinformation_section">

Prototype
template<class BidirectionalIterator, class OutputIterator> inline OutputIterator reverse_copy(BidirectionalIterator first,

BidirectionalIterator last, OutputIterator result) NOTE: The class/parameter names in the prototype do not match the version in the header file. Some have been modified to improve readability.

Description
The reverse_copy algorithm reverses the order of the elements in the range [first, last) and copies the result into a sequence of the same size starting at result. It returns an iterator positioned immediately after the last new element in the resulting sequence.

Sample Code
////////////////////////////////////////////////////////////////////// // // Compile options needed: /GX // // reverse_copy.cpp : Illustrates how to use the reverse_copy function. // // Functions: // //   reverse_copy - Reverse a sequence, copy the results to another //                  same-sized sequence. // // Written by Kalindi Sanghrajka // of Microsoft Product Support Services, // Software Core Developer Support. // Copyright (c) 1996 Microsoft Corporation. All rights reserved. //////////////////////////////////////////////////////////////////////

// disable warning C4786: symbol greater than 255 character, // okay to ignore


 * 1) pragma warning(disable: 4786)


 * 1) include
 * 2) include
 * 3) include
 * 4) include
 * 5) include

using namespace std; // std c++ libs implemented in std #endif
 * 1) if _MSC_VER > 1020  // if VC++ version is > 4.2

void main

{

const int VECTOR_SIZE = 8 ;

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

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

StrVector Tongue_Twister(VECTOR_SIZE) ; StrVector Reversed_Twister(VECTOR_SIZE) ;

StrVectorIt start, end, it, RTstart, RTend ;

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

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

RTstart = Reversed_Twister.begin ; // location of first // element of Reversed_Twister

RTend = Reversed_Twister.end ; // one past the location last // element of Reversed_Twister

//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_copy \n" << endl ;

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

// reverse the items in the vector Tongue_Twister // and copy the results to Reversed_Twister reverse_copy(start, end, RTstart) ;

cout << "After calling reverse_copy: \n" << endl ;

// print content of Tongue_Twister cout << "Tongue_Twister: " ; for(it = start; it != end; it++) cout << *it << " " ; cout << "\n\n" ;

// print content of Reversed_Twister cout << "Now try the reversed Tongue Twister: " ; for(it = RTstart; it != RTend; it++) cout << *it << " " ; cout << "\n\n" ;

} Program Output is:

Before calling reverse_copy

Try this Tongue Twister: she sells sea shells by the sea shore

After calling reverse_copy:

Tongue_Twister: she sells sea shells by the sea shore

Now try the reversed Tongue Twister: shore sea the by shells sea sells she

<div class="references_section">