Cpp-standard-library-cpp-algorithm-includes-v2

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

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

説明

C ++関数* std
algorithm :: includes()*は、最初のセットが別のセットのサブセットかどうかをテストします。 このメンバー関数は、ソートされた順序で要素を期待します。 比較のために `+ binary function +`を使用します。

宣言

以下は、std
algorithmヘッダーからのstd :: algorithm :: includes()関数の宣言です。

C 98

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

パラメーター

  • first1 -最初のシーケンスの初期位置に反復子を入力します。
  • last1 -最初のシーケンスの最終位置に反復子を入力します。
  • first2 -2番目のシーケンスの初期位置に反復子を入力します。
  • last2 -2番目のシーケンスの最終位置に反復子を入力します。
  • comp -2つの引数を受け取り、boolを返すバイナリ関数。

戻り値

最初のセットが別のセットのサブセットである場合はtrueを返し、そうでない場合はfalseを返します。

例外

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

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

時間の複雑さ

リニア。

次の例は、std
algorithm :: includes()関数の使用法を示しています。
#include <iostream>
#include <algorithm>
#include <vector>

using namespace std;

bool compare(char a, char b) {
   return (tolower(a) == tolower(b));
}

int main(void) {
   vector<char> v1 = {'a', 'b', 'c', 'd', 'e'};
   vector<char> v2 = {'C', 'D', 'E'};
   bool result;

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

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

   return 0;
}

上記のプログラムをコンパイルして実行すると、次の結果が生成されます-

Vector v2 is subset of v1