Cpp-standard-library-cpp-algorithm-equal-equality

C ++アルゴリズムライブラリ-equal（）関数

説明

C ++関数* std

algorithm :: equal（）*は、2つの要素セットが等しいかどうかをテストします。 両方のセットのサイズは同じである必要はありません。 比較のために `+ operator == +`を使用します。

宣言

以下は、std

algorithmヘッダーからのstd :: algorithm :: equal（）関数の宣言です。

C 98

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

パラメーター

• first1 -最初のシーケンスの初期位置に反復子を入力します。
• last1 -最初のシーケンスの最終位置に反復子を入力します。
• first2 -2番目のシーケンスの初期位置に反復子を入力します。

戻り値

`+ first1 `から ` last1 `の範囲のすべての要素が ` first2 +`で始まる範囲の要素と等しい場合はtrueを返し、そうでない場合はfalseを返します。

例外

要素比較（または述語）またはイテレータの操作が例外をスローした場合、例外をスローします。

無効なパラメータは未定義の動作を引き起こすことに注意してください。

時間の複雑さ

`+ first `から ` last +`までの距離は線形です。

例

次の例は、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.