Cpp-standard-library-cpp-algorithm-equal-predicate

提供:Dev Guides
移動先:案内検索

C ++アルゴリズムライブラリ-equal()関数

説明

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

宣言

以下は、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 -2番目のシーケンスの初期位置に反復子を入力します。
  • pred -2つの引数を受け取り、boolを返すバイナリ述語。

戻り値

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

例外

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

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

時間の複雑さ

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

次の例は、std
algorithm :: equal()関数の使用法を示しています。
#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.