Login | Register   
LinkedIn
Google+
Twitter
RSS Feed
Download our iPhone app
TODAY'S HEADLINES  |   ARTICLE ARCHIVE  |   FORUMS  |   TIP BANK
Browse DevX
Sign up for e-mail newsletters from DevX


Tip of the Day
Home » Tip Bank » C++
Language: C++
Expertise: Intermediate
Jan 11, 2005

The includes() Algorithm

You can use the includes() algorithm to determine if every element within a specified range of a sequence container is completely contained within a specified range of another sequence conatainer.

	int iArr [] {0, 2, 3, 4, 5, 6, 7, 8, 9};
	vector<int> vecInt (iArr, iArr + 9);

	int iArr_1 [] = {2, 10, 6, 5};
However, you must sort both containers before using includes():

	sort (iArr_1, iArr + 4);// 
Now iArr_1 has this sequence {2, 5, 6, 10} because sort() sorts in ascending order:

	bool isIn = include (vecInt.begin(), vecInt.end(), iArr_1, iArr_1 + 4); // isIn = false
Here, includes() return false because 10 is not contained in the vecInt. In the following code, include() returns true because it's considering elements from the zero position to the second position of vecInt.

	isIn = include (vecInt.begin(), vecInt.end(), iArr_1, iArr_1 + 3); // isIn = true
Be aware that this version of includes() will help only if you have sorted your containers in ascending order.

Suppose you sort the containers in descending order by using the pre-defined, relational function object greater<type>() or by using your own written function object. You would then need to use the second overloaded version of includes() to determine the element ordering. This second overloaded version takes four parameters. So, you need to pass the function object used for sorting containers as its fourth argument to let it determine the ordering of elements:


	int iArr_2 [] = {8, 9, 3, 7};
	#include <functional> //for greater<type>()


	sort (iArr_2, iArr2 + 4, greater<int>());// so now iArr_2 has this sequence {8, 9, 7, 3}
	sort (vecInt.begin(), vecInt.end(), greater<int>()); // vecInt has this sequence now 9,
8, 7, 6, 5, 4, 3, 2, 0

	isIn = includes (vecInt.begin(), vecInt.end(), iArr_2, iArr_2 + 4); // isIn = false
includes() returned false because the containers are sorted in descending order and the code is using the first version of includes(), which assumes that the containers are sorted in ascending order.

Here's what it looks like to use the second overloaded version of includes():


	isIn = includes (vecInt.begin(), vecInt.end(), iArr_2, iArr_2 + 4, greater<int>()); // 
isIn = true
Saurabh Ramya
 
Comment and Contribute

 

 

 

 

 


(Maximum characters: 1200). You have 1200 characters left.

 

 

Sitemap