4. contains

最終更新日時(UTC):
が更新

履歴 編集

function template
<algorithm>

std::ranges::contains(C++23)

namespace ranges {
  // (1)
  template<input_iterator I, sentinel_for<I> S, class T, class Proj = identity>
    requires indirect_binary_predicate<ranges::equal_to, projected<I, Proj>, const T*>
    constexpr bool contains(I first, S last, const T& value, Proj proj = {});

  // (2)
  template<input_range R, class T, class Proj = identity>
    requires
      indirect_binary_predicate<ranges::equal_to, projected<iterator_t<R>, Proj>, const T*>
    constexpr bool contains(R&& r, const T& value, Proj proj = {});
}

概要

指定された値が含まれるか調べる。

戻り値

ranges::find(std::move(first), last, value, proj) != last

計算量

最大で last - first 回比較を行う

例

#include <algorithm>
#include <print>
#include <array>

int main() {
  constexpr std::array v = { 3, 1, 4 };
  if (std::ranges::contains(v, 1)) {
    std::println("found");
  } else {
    std::println("not found");
  }
}

出力

found

実装例

struct contains_impl {
  template<input_iterator I, sentinel_for<I> S, class T, class Proj = identity>
    requires indirect_binary_predicate<ranges::equal_to, projected<I, Proj>, const T*>
  constexpr bool operator()(I first, S last, const T& value, Proj proj = {}) const {
    return ranges::find(std::move(first), last, value, proj) != last;
  }

  template<input_range R, class T, class Proj = identity>
    requires indirect_binary_predicate<ranges::equal_to, projected<iterator_t<R>, Proj>, const T*>
  constexpr bool operator()(R&& r, const T& value, Proj proj = {}) const {
    return ranges::find(std::forward(r), value, proj) != last;
  }
};

inline constexpr contains_impl contains;

バージョン

言語

  • C++23

処理系

参照