Microsoft KB Archive/157566

= STL Sample for the Predicate Version of the includes Function =

Article ID: 157566

Article Last Modified on 12/2/2003

-

APPLIES TO

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

 Microsoft Visual C++ 4.2 Enterprise Edition

 Microsoft Visual C++ 5.0 Learning Edition 

-

<div class="notice_section">

This article was previously published under Q157566

<div class="summary_section">

SUMMARY
The sample code below illustrates how to use the predicate version of includes STL function in Visual C++.

<div class="moreinformation_section">

Prototype
template<class InputIterator1, class InputIterator2, class Compare> inline bool includes(InputIterator1 first1,                       InputIterator1 last1,                        InputIterator2 first2,                        InputIterator2 last2,                        Compare compare) NOTE: The class/parameter names in the prototype do not match the original version in the header file. They have been modified to improve readability.

Description
The includes algorithm searches for one sequence of values in another sequence of values. includes returns true if every element in the range [first2 ..last2) is in the sequence [first1 .. last1). This version of includes assumes that both the sequences are sorted using the compare function. ////////////////////////////////////////////////////////////////////// // // Compile options needed: /GX // // includesP.cpp : Illustrates how to use the predicate version of //                includes function. // // Functions: // //   includes - Search for one sequence in another. //   string_compare - Compare strings, return true if //                       s1 < s2. // // 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)

using namespace std;
 * 1) include
 * 2) include
 * 3) include
 * 4) include
 * 5) include
 * 6) include

bool string_compare(const string& s1, const string& s2) {   return s1 < s2 ? 1 : 0; } void main {   const int VECTOR_SIZE = 5 ;

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

//Define an iterator for template class vector of strings typedef StringVector::iterator StringVectorIt ;

// Define a template class deque of strings typedef deque<string, allocator > StringDeque ;

//Define an iterator for template class deque of strings typedef StringDeque::iterator StringDequeIt ;

StringVector CartoonVector(VECTOR_SIZE) ; StringDeque CartoonDeque ;

StringVectorIt start1, end1, it1 ; StringDequeIt start2, end2, it2 ;

// Initialize vector Vector1 CartoonVector[0] = "Aladdin" ; CartoonVector[1] = "Jasmine" ; CartoonVector[2] = "Mickey" ; CartoonVector[3] = "Minnie" ; CartoonVector[4] = "Goofy" ;

start1 = CartoonVector.begin ; // location of first // element of CartoonVector

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

//Initialize list CartoonDeque CartoonDeque.push_back("Jasmine") ; CartoonDeque.push_back("Aladdin") ; CartoonDeque.push_back("Goofy") ;

start2 = CartoonDeque.begin ; // location of first // element of CartoonDeque

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

//sort CartoonVector and CartoonDeque alphabetically //includes requires the sequences //to be sorted. sort(start1, end1, string_compare) ; sort(start2, end2, string_compare) ;

// print contents of CartoonVector and CartoonDeque cout << "CartoonVector { " ; for(it1 = start1; it1 != end1; it1++) cout << *it1 << ", " ; cout << " }\n" << endl ; cout << "CartoonDeque { " ; for(it2 = start2; it2 != end2; it2++) cout << *it2 << ", " ; cout << " }\n" << endl ;

//Is CartoonDeque a subset of CartoonVector? if(includes(start1, end1, start2, end2, string_compare) ) cout << "CartoonVector includes CartoonDeque" << endl ; else cout << "CartoonVector does not include CartoonDeque" << endl ;

}

Program Output is:

CartoonVector { Aladdin, Goofy, Jasmine, Mickey, Minnie, }

CartoonDeque { Aladdin, Goofy, Jasmine, }

CartoonVector includes CartoonDeque

<div class="references_section">