C++ 算法库 -includes() 函数

---

描述

C++ 函数std::algorithm::includes()测试第一个集合是否是另一个集合的子集。此成员函数需要按排序顺序排列元素。它使用运算符<进行比较。

宣言

以下是 std::algorithm::includes() 函数形式 std::algorithm 标头的声明。

C++98

template <class InputIterator1, class InputIterator2>
bool includes(InputIterator1 first1, InputIterator1 last1,
   InputIterator2 first2, InputIterator2 last2);

参数

• first1 - 第一个序列的初始位置的输入迭代器。

• last1 - 第一个序列的最终位置的输入迭代器。

• first2 - 第二个序列的初始位置的输入迭代器。

• last2 - 输入迭代器到第二个序列的最终位置。

返回值

如果第一个集合是另一个集合的子集，则返回 true，否则返回 false。

例外情况

如果元素比较或迭代器上的操作引发异常，则引发异常。

请注意，无效参数会导致未定义的行为。

时间复杂度

线性。

例子

以下示例显示了 std::algorithm::includes() 函数的用法。

#include <iostream>
#include <algorithm>
#include <vector>

using namespace std;

int main(void) {
   vector<int> v1 = {1, 2, 3, 4, 5};
   vector<int> v2 = {3, 4, 5};
   bool result;

   result = includes(v1.begin(), v1.end(), v2.begin(), v2.end());

   if (result == true)
      cout << "Vector v2 is subset of v1" << endl;

   v2 = {10};

   result = includes(v1.begin(), v1.end(), v2.begin(), v2.end());

   if (result == false)
      cout << "Vector v2 is not subset of v1" << endl;

   return 0;
}

让我们编译并运行上面的程序，这将产生以下结果 -

Vector v2 is subset of v1
Vector v2 is not subset of v1