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


描述

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

宣言

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

C++98

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

参数

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

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

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

返回值

如果first1last1范围内的所有元素都等于从first2开始的范围内的元素,则返回true,否则返回false。

例外情况

如果元素比较(或谓词)或迭代器上的操作抛出异常,则抛出异常。

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

时间复杂度

第一个最后一个之间的距离呈线性。

例子

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

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

using namespace std;

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

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

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

   v2[2] = 3;

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

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

   return 0;
}

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

Vector range is not equal.
Vector range is equal.
算法.htm