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

描述

C++ 函数std::algorithm::equal()测试两组元素是否相等。两组的大小不必相等。它使用二元谓词进行比较。

声明

以下是来自std::algorithm头文件的std::algorithm::equal()函数的声明。

C++98

template <class InputIterator1, class InputIterator2, class BinaryPredicate>
bool equal(InputIterator1 first1, InputIterator1 last1,
   InputIterator2 first2, BinaryPredicate pred);

参数

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

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

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

• pred - 一个接受两个参数并返回bool值的二元谓词。

返回值

如果从first1到last1范围内的所有元素都等于从first2开始的范围内的元素，则返回true；否则返回false。

异常

如果元素比较（或谓词）或迭代器上的操作抛出异常，则抛出异常。

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

时间复杂度

线性于first到last.

之间的距离

示例

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

using namespace std;

/* Binary predicate which always returns true */
bool binary_pred(string s1, string s2) {
   return true;
}

int main(void) {
   vector<string> v1 = {"one", "two", "three"};
   vector<string> v2 = {"ONE", "THREE", "THREE"};
   bool result;

   result = equal(v1.begin(), v1.end(), v2.begin(), binary_pred);

   if (result == true)
      cout << "Vector range is equal." << endl;

   return 0;
}

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

Vector range is equal.