Files
allhaileris afb81b8278
Some checks failed
Docker. / Ubuntu (push) Has been cancelled
User-agent updater. / User-agent (push) Failing after 15s
Lock Threads / lock (push) Failing after 10s
Waiting for answer. / waiting-for-answer (push) Failing after 22s
Needs user action. / needs-user-action (push) Failing after 8s
Can't reproduce. / cant-reproduce (push) Failing after 8s
Close stale issues and PRs / stale (push) Has been cancelled
init
2026-02-16 15:50:16 +03:00

991 lines
38 KiB
C++

/// \file
// Range v3 library
//
// Copyright Eric Niebler 2013-present
//
// Use, modification and distribution is subject to the
// Boost Software License, Version 1.0. (See accompanying
// file LICENSE_1_0.txt or copy at
// http://www.boost.org/LICENSE_1_0.txt)
//
// Project home: https://github.com/ericniebler/range-v3
//
#ifndef RANGES_V3_ITERATOR_CONCEPTS_HPP
#define RANGES_V3_ITERATOR_CONCEPTS_HPP
#include <iterator>
#include <type_traits>
#include <meta/meta.hpp>
#include <concepts/concepts.hpp>
#include <range/v3/range_fwd.hpp>
#include <range/v3/functional/comparisons.hpp>
#include <range/v3/functional/concepts.hpp>
#include <range/v3/functional/identity.hpp>
#include <range/v3/functional/invoke.hpp>
#include <range/v3/iterator/access.hpp>
#include <range/v3/iterator/traits.hpp>
#ifdef _GLIBCXX_DEBUG
#include <debug/safe_iterator.h>
#endif
#include <range/v3/detail/prologue.hpp>
namespace ranges
{
/// \addtogroup group-iterator-concepts
/// @{
/// \cond
namespace detail
{
template<typename I>
using iter_traits_t = meta::conditional_t<is_std_iterator_traits_specialized_v<I>,
std::iterator_traits<I>, I>;
#if defined(_GLIBCXX_DEBUG)
template(typename I, typename T, typename Seq)(
requires same_as<I, __gnu_debug::_Safe_iterator<T *, Seq>>)
auto iter_concept_(__gnu_debug::_Safe_iterator<T *, Seq>, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
#endif
#if defined(__GLIBCXX__)
template(typename I, typename T, typename Seq)(
requires same_as<I, __gnu_cxx::__normal_iterator<T *, Seq>>)
auto iter_concept_(__gnu_cxx::__normal_iterator<T *, Seq>, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
#endif
#if defined(_LIBCPP_VERSION)
template(typename I, typename T)(
requires same_as<I, std::__wrap_iter<T *>>)
auto iter_concept_(std::__wrap_iter<T *>, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
#endif
#if defined(_MSVC_STL_VERSION) || defined(_IS_WRS)
template(typename I)(
requires same_as<I, class I::_Array_iterator>)
auto iter_concept_(I, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
template(typename I)(
requires same_as<I, class I::_Array_const_iterator>)
auto iter_concept_(I, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
template(typename I)(
requires same_as<I, class I::_Vector_iterator>)
auto iter_concept_(I, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
template(typename I)(
requires same_as<I, class I::_Vector_const_iterator>)
auto iter_concept_(I, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
template(typename I)(
requires same_as<I, class I::_String_iterator>)
auto iter_concept_(I, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
template(typename I)(
requires same_as<I, class I::_String_const_iterator>)
auto iter_concept_(I, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
template(typename I)(
requires same_as<I, class I::_String_view_iterator>)
auto iter_concept_(I, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
#endif
template(typename I, typename T)(
requires same_as<I, T *>)
auto iter_concept_(T *, priority_tag<3>)
-> ranges::contiguous_iterator_tag;
template<typename I>
auto iter_concept_(I, priority_tag<2>) ->
typename iter_traits_t<I>::iterator_concept;
template<typename I>
auto iter_concept_(I, priority_tag<1>) ->
typename iter_traits_t<I>::iterator_category;
template<typename I>
auto iter_concept_(I, priority_tag<0>)
-> enable_if_t<!is_std_iterator_traits_specialized_v<I>,
std::random_access_iterator_tag>;
template<typename I>
using iter_concept_t =
decltype(iter_concept_<I>(std::declval<I>(), priority_tag<3>{}));
using ::concepts::detail::weakly_equality_comparable_with_;
template<typename I>
using readable_types_t =
meta::list<iter_value_t<I>, iter_reference_t<I>, iter_rvalue_reference_t<I>>;
} // namespace detail
/// \endcond
// clang-format off
/// \concept readable_
/// \brief The \c readable_ concept
template(typename I)(
concept (readable_)(I),
// requires (I const i)
// (
// { *i } -> same_as<iter_reference_t<I>>;
// { iter_move(i) } -> same_as<iter_rvalue_reference_t<I>>;
// ) &&
same_as<iter_reference_t<I const>, iter_reference_t<I>> AND
same_as<iter_rvalue_reference_t<I const>, iter_rvalue_reference_t<I>> AND
common_reference_with<iter_reference_t<I> &&, iter_value_t<I> &> AND
common_reference_with<iter_reference_t<I> &&,
iter_rvalue_reference_t<I> &&> AND
common_reference_with<iter_rvalue_reference_t<I> &&, iter_value_t<I> const &>
);
/// \concept indirectly_readable
/// \brief The \c indirectly_readable concept
template<typename I>
CPP_concept indirectly_readable = //
CPP_concept_ref(ranges::readable_, uncvref_t<I>);
template<typename I>
RANGES_DEPRECATED("Please use ranges::indirectly_readable instead")
RANGES_INLINE_VAR constexpr bool readable = //
indirectly_readable<I>;
/// \concept writable_
/// \brief The \c writable_ concept
template<typename O, typename T>
CPP_requires(writable_,
requires(O && o, T && t) //
(
*o = (T &&) t,
*(O &&) o = (T &&) t,
const_cast<iter_reference_t<O> const &&>(*o) = (T &&) t,
const_cast<iter_reference_t<O> const &&>(*(O &&) o) = (T &&) t
));
/// \concept indirectly_writable
/// \brief The \c indirectly_writable concept
template<typename O, typename T>
CPP_concept indirectly_writable = //
CPP_requires_ref(ranges::writable_, O, T);
template<typename O, typename T>
RANGES_DEPRECATED("Please use ranges::indirectly_writable instead")
RANGES_INLINE_VAR constexpr bool writable = //
indirectly_writable<O, T>;
// clang-format on
/// \cond
namespace detail
{
#if RANGES_CXX_INLINE_VARIABLES >= RANGES_CXX_INLINE_VARIABLES_17
template<typename D>
inline constexpr bool _is_integer_like_ = std::is_integral<D>::value;
#else
template<typename D, typename = void>
constexpr bool _is_integer_like_ = std::is_integral<D>::value;
#endif
// gcc10 uses for std::ranges::range_difference_t<
// std::ranges::iota_view<size_t, size_t>> == __int128
#if __SIZEOF_INT128__
__extension__ typedef __int128 int128_t;
#if RANGES_CXX_INLINE_VARIABLES >= RANGES_CXX_INLINE_VARIABLES_17
template<>
inline constexpr bool _is_integer_like_<int128_t> = true;
#else
template<typename Enable>
constexpr bool _is_integer_like_<int128_t, Enable> = true;
#endif
#endif // __SIZEOF_INT128__
// clang-format off
/// \concept integer_like_
/// \brief The \c integer_like_ concept
template<typename D>
CPP_concept integer_like_ = _is_integer_like_<D>;
// TODO additional syntactic and semantic requirements
#ifdef RANGES_WORKAROUND_MSVC_792338
template<typename D, bool Signed = (D(-1) < D(0))>
constexpr bool _is_signed_(D *)
{
return Signed;
}
constexpr bool _is_signed_(void *)
{
return false;
}
/// \concept signed_integer_like_
/// \brief The \c signed_integer_like_ concept
template<typename D>
CPP_concept signed_integer_like_ =
integer_like_<D> && detail::_is_signed_((D*) nullptr);
#else // ^^^ workaround / no workaround vvv
/// \concept signed_integer_like_impl_
/// \brief The \c signed_integer_like_impl_ concept
template(typename D)(
concept (signed_integer_like_impl_)(D),
integer_like_<D> AND
concepts::type<std::integral_constant<bool, (D(-1) < D(0))>> AND
std::integral_constant<bool, (D(-1) < D(0))>::value
);
/// \concept signed_integer_like_
/// \brief The \c signed_integer_like_ concept
template<typename D>
CPP_concept signed_integer_like_ =
integer_like_<D> &&
CPP_concept_ref(detail::signed_integer_like_impl_, D);
#endif // RANGES_WORKAROUND_MSVC_792338
// clang-format on
} // namespace detail
/// \endcond
// clang-format off
/// \concept weakly_incrementable_
/// \brief The \c weakly_incrementable_ concept
template<typename I>
CPP_requires(weakly_incrementable_,
requires(I i) //
(
++i,
i++,
concepts::requires_<same_as<I&, decltype(++i)>>
));
/// \concept weakly_incrementable_
/// \brief The \c weakly_incrementable_ concept
template(typename I)(
concept (weakly_incrementable_)(I),
concepts::type<iter_difference_t<I>> AND
detail::signed_integer_like_<iter_difference_t<I>>);
/// \concept weakly_incrementable
/// \brief The \c weakly_incrementable concept
template<typename I>
CPP_concept weakly_incrementable =
copyable<I> &&
CPP_requires_ref(ranges::weakly_incrementable_, I) &&
CPP_concept_ref(ranges::weakly_incrementable_, I);
/// \concept incrementable_
/// \brief The \c incrementable_ concept
template<typename I>
CPP_requires(incrementable_,
requires(I i) //
(
concepts::requires_<same_as<I, decltype(i++)>>
));
/// \concept incrementable
/// \brief The \c incrementable concept
template<typename I>
CPP_concept incrementable =
regular<I> &&
weakly_incrementable<I> &&
CPP_requires_ref(ranges::incrementable_, I);
/// \concept input_or_output_iterator_
/// \brief The \c input_or_output_iterator_ concept
template(typename I)(
concept (input_or_output_iterator_)(I),
detail::dereferenceable_<I&>
);
/// \concept input_or_output_iterator
/// \brief The \c input_or_output_iterator concept
template<typename I>
CPP_concept input_or_output_iterator =
weakly_incrementable<I> &&
CPP_concept_ref(ranges::input_or_output_iterator_, I);
/// \concept sentinel_for
/// \brief The \c sentinel_for concept
template<typename S, typename I>
CPP_concept sentinel_for =
semiregular<S> &&
input_or_output_iterator<I> &&
detail::weakly_equality_comparable_with_<S, I>;
/// \concept sized_sentinel_for_
/// \brief The \c sized_sentinel_for_ concept
template<typename S, typename I>
CPP_requires(sized_sentinel_for_,
requires(S const & s, I const & i) //
(
s - i,
i - s,
concepts::requires_<same_as<iter_difference_t<I>, decltype(s - i)>>,
concepts::requires_<same_as<iter_difference_t<I>, decltype(i - s)>>
));
/// \concept sized_sentinel_for_
/// \brief The \c sized_sentinel_for_ concept
template(typename S, typename I)(
concept (sized_sentinel_for_)(S, I),
(!disable_sized_sentinel<std::remove_cv_t<S>, std::remove_cv_t<I>>) AND
sentinel_for<S, I>);
/// \concept sized_sentinel_for
/// \brief The \c sized_sentinel_for concept
template<typename S, typename I>
CPP_concept sized_sentinel_for =
CPP_concept_ref(sized_sentinel_for_, S, I) &&
CPP_requires_ref(ranges::sized_sentinel_for_, S, I);
/// \concept output_iterator_
/// \brief The \c output_iterator_ concept
template<typename Out, typename T>
CPP_requires(output_iterator_,
requires(Out o, T && t) //
(
*o++ = (T &&) t
));
/// \concept output_iterator
/// \brief The \c output_iterator concept
template<typename Out, typename T>
CPP_concept output_iterator =
input_or_output_iterator<Out> &&
indirectly_writable<Out, T> &&
CPP_requires_ref(ranges::output_iterator_, Out, T);
/// \concept with_category_
/// \brief The \c with_category_ concept
template(typename I, typename Tag)(
concept (with_category_)(I, Tag),
derived_from<detail::iter_concept_t<I>, Tag>
);
/// \concept input_iterator
/// \brief The \c input_iterator concept
template<typename I>
CPP_concept input_iterator =
input_or_output_iterator<I> &&
indirectly_readable<I> &&
CPP_concept_ref(ranges::with_category_, I, std::input_iterator_tag);
/// \concept forward_iterator
/// \brief The \c forward_iterator concept
template<typename I>
CPP_concept forward_iterator =
input_iterator<I> &&
incrementable<I> &&
sentinel_for<I, I> &&
CPP_concept_ref(ranges::with_category_, I, std::forward_iterator_tag);
/// \concept bidirectional_iterator_
/// \brief The \c bidirectional_iterator_ concept
template<typename I>
CPP_requires(bidirectional_iterator_,
requires(I i) //
(
--i,
i--,
concepts::requires_<same_as<I&, decltype(--i)>>,
concepts::requires_<same_as<I, decltype(i--)>>
));
/// \concept bidirectional_iterator
/// \brief The \c bidirectional_iterator concept
template<typename I>
CPP_concept bidirectional_iterator =
forward_iterator<I> &&
CPP_requires_ref(ranges::bidirectional_iterator_, I) &&
CPP_concept_ref(ranges::with_category_, I, std::bidirectional_iterator_tag);
/// \concept random_access_iterator_
/// \brief The \c random_access_iterator_ concept
template<typename I>
CPP_requires(random_access_iterator_,
requires(I i, iter_difference_t<I> n)
(
i + n,
n + i,
i - n,
i += n,
i -= n,
concepts::requires_<same_as<decltype(i + n), I>>,
concepts::requires_<same_as<decltype(n + i), I>>,
concepts::requires_<same_as<decltype(i - n), I>>,
concepts::requires_<same_as<decltype(i += n), I&>>,
concepts::requires_<same_as<decltype(i -= n), I&>>,
concepts::requires_<same_as<decltype(i[n]), iter_reference_t<I>>>
));
/// \concept random_access_iterator
/// \brief The \c random_access_iterator concept
template<typename I>
CPP_concept random_access_iterator =
bidirectional_iterator<I> &&
totally_ordered<I> &&
sized_sentinel_for<I, I> &&
CPP_requires_ref(ranges::random_access_iterator_, I) &&
CPP_concept_ref(ranges::with_category_, I, std::random_access_iterator_tag);
/// \concept contiguous_iterator_
/// \brief The \c contiguous_iterator_ concept
template(typename I)(
concept (contiguous_iterator_)(I),
std::is_lvalue_reference<iter_reference_t<I>>::value AND
same_as<iter_value_t<I>, uncvref_t<iter_reference_t<I>>> AND
derived_from<detail::iter_concept_t<I>, ranges::contiguous_iterator_tag>
);
/// \concept contiguous_iterator
/// \brief The \c contiguous_iterator concept
template<typename I>
CPP_concept contiguous_iterator =
random_access_iterator<I> &&
CPP_concept_ref(ranges::contiguous_iterator_, I);
// clang-format on
/////////////////////////////////////////////////////////////////////////////////////
// iterator_tag_of
template<typename Rng>
using iterator_tag_of = //
std::enable_if_t< //
input_iterator<Rng>, //
meta::conditional_t< //
contiguous_iterator<Rng>, //
ranges::contiguous_iterator_tag, //
meta::conditional_t< //
random_access_iterator<Rng>, //
std::random_access_iterator_tag, //
meta::conditional_t< //
bidirectional_iterator<Rng>, //
std::bidirectional_iterator_tag, //
meta::conditional_t< //
forward_iterator<Rng>, //
std::forward_iterator_tag, //
std::input_iterator_tag>>>>>;
/// \cond
namespace detail
{
template<typename, bool>
struct iterator_category_
{};
template<typename I>
struct iterator_category_<I, true>
{
using type = iterator_tag_of<I>;
};
template<typename T, typename U = meta::_t<std::remove_const<T>>>
using iterator_category = iterator_category_<U, (bool)input_iterator<U>>;
} // namespace detail
/// \endcond
/// \cond
// Generally useful to know if an iterator is single-pass or not:
// clang-format off
/// \concept single_pass_iterator_
/// \brief The \c single_pass_iterator_ concept
template<typename I>
CPP_concept single_pass_iterator_ =
input_or_output_iterator<I> && !forward_iterator<I>;
// clang-format on
/// \endcond
//////////////////////////////////////////////////////////////////////////////////////
// indirect_result_t
template<typename Fun, typename... Is>
using indirect_result_t =
detail::enable_if_t<(bool)and_v<(bool)indirectly_readable<Is>...>,
invoke_result_t<Fun, iter_reference_t<Is>...>>;
/// \cond
namespace detail
{
// clang-format off
/// \concept common_reference_with_4_impl_
/// \brief The \c common_reference_with_4_impl_ concept
template(typename T1, typename T2, typename T3, typename T4)(
concept (common_reference_with_4_impl_)(T1, T2, T3, T4),
concepts::type<common_reference_t<T1, T2, T3, T4>> AND
convertible_to<T1, common_reference_t<T1, T2, T3, T4>> AND
convertible_to<T2, common_reference_t<T1, T2, T3, T4>> AND
convertible_to<T3, common_reference_t<T1, T2, T3, T4>> AND
convertible_to<T4, common_reference_t<T1, T2, T3, T4>>
);
/// \concept common_reference_with_4_
/// \brief The \c common_reference_with_4_ concept
template<typename T1, typename T2, typename T3, typename T4>
CPP_concept common_reference_with_4_ =
CPP_concept_ref(detail::common_reference_with_4_impl_, T1, T2, T3, T4);
// axiom: all permutations of T1,T2,T3,T4 have the same
// common reference type.
/// \concept indirectly_unary_invocable_impl_
/// \brief The \c indirectly_unary_invocable_impl_ concept
template(typename F, typename I)(
concept (indirectly_unary_invocable_impl_)(F, I),
invocable<F &, iter_value_t<I> &> AND
invocable<F &, iter_reference_t<I>> AND
invocable<F &, iter_common_reference_t<I>> AND
common_reference_with<
invoke_result_t<F &, iter_value_t<I> &>,
invoke_result_t<F &, iter_reference_t<I>>>
);
/// \concept indirectly_unary_invocable_
/// \brief The \c indirectly_unary_invocable_ concept
template<typename F, typename I>
CPP_concept indirectly_unary_invocable_ =
indirectly_readable<I> &&
CPP_concept_ref(detail::indirectly_unary_invocable_impl_, F, I);
// clang-format on
} // namespace detail
/// \endcond
// clang-format off
/// \concept indirectly_unary_invocable
/// \brief The \c indirectly_unary_invocable concept
template<typename F, typename I>
CPP_concept indirectly_unary_invocable =
detail::indirectly_unary_invocable_<F, I> &&
copy_constructible<F>;
/// \concept indirectly_regular_unary_invocable_
/// \brief The \c indirectly_regular_unary_invocable_ concept
template(typename F, typename I)(
concept (indirectly_regular_unary_invocable_)(F, I),
regular_invocable<F &, iter_value_t<I> &> AND
regular_invocable<F &, iter_reference_t<I>> AND
regular_invocable<F &, iter_common_reference_t<I>> AND
common_reference_with<
invoke_result_t<F &, iter_value_t<I> &>,
invoke_result_t<F &, iter_reference_t<I>>>
);
/// \concept indirectly_regular_unary_invocable
/// \brief The \c indirectly_regular_unary_invocable concept
template<typename F, typename I>
CPP_concept indirectly_regular_unary_invocable =
indirectly_readable<I> &&
copy_constructible<F> &&
CPP_concept_ref(ranges::indirectly_regular_unary_invocable_, F, I);
/// \cond
// Non-standard indirect invocable concepts
/// \concept indirectly_binary_invocable_impl_
/// \brief The \c indirectly_binary_invocable_impl_ concept
template(typename F, typename I1, typename I2)(
concept (indirectly_binary_invocable_impl_)(F, I1, I2),
invocable<F &, iter_value_t<I1> &, iter_value_t<I2> &> AND
invocable<F &, iter_value_t<I1> &, iter_reference_t<I2>> AND
invocable<F &, iter_reference_t<I1>, iter_value_t<I2> &> AND
invocable<F &, iter_reference_t<I1>, iter_reference_t<I2>> AND
invocable<F &, iter_common_reference_t<I1>, iter_common_reference_t<I2>> AND
detail::common_reference_with_4_<
invoke_result_t<F &, iter_value_t<I1> &, iter_value_t<I2> &>,
invoke_result_t<F &, iter_value_t<I1> &, iter_reference_t<I2>>,
invoke_result_t<F &, iter_reference_t<I1>, iter_value_t<I2> &>,
invoke_result_t<F &, iter_reference_t<I1>, iter_reference_t<I2>>>
);
/// \concept indirectly_binary_invocable_
/// \brief The \c indirectly_binary_invocable_ concept
template<typename F, typename I1, typename I2>
CPP_concept indirectly_binary_invocable_ =
indirectly_readable<I1> && indirectly_readable<I2> &&
copy_constructible<F> &&
CPP_concept_ref(ranges::indirectly_binary_invocable_impl_, F, I1, I2);
/// \concept indirectly_regular_binary_invocable_impl_
/// \brief The \c indirectly_regular_binary_invocable_impl_ concept
template(typename F, typename I1, typename I2)(
concept (indirectly_regular_binary_invocable_impl_)(F, I1, I2),
regular_invocable<F &, iter_value_t<I1> &, iter_value_t<I2> &> AND
regular_invocable<F &, iter_value_t<I1> &, iter_reference_t<I2>> AND
regular_invocable<F &, iter_reference_t<I1>, iter_value_t<I2> &> AND
regular_invocable<F &, iter_reference_t<I1>, iter_reference_t<I2>> AND
regular_invocable<F &, iter_common_reference_t<I1>, iter_common_reference_t<I2>> AND
detail::common_reference_with_4_<
invoke_result_t<F &, iter_value_t<I1> &, iter_value_t<I2> &>,
invoke_result_t<F &, iter_value_t<I1> &, iter_reference_t<I2>>,
invoke_result_t<F &, iter_reference_t<I1>, iter_value_t<I2> &>,
invoke_result_t<F &, iter_reference_t<I1>, iter_reference_t<I2>>>
);
/// \concept indirectly_regular_binary_invocable_
/// \brief The \c indirectly_regular_binary_invocable_ concept
template<typename F, typename I1, typename I2>
CPP_concept indirectly_regular_binary_invocable_ =
indirectly_readable<I1> && indirectly_readable<I2> &&
copy_constructible<F> &&
CPP_concept_ref(ranges::indirectly_regular_binary_invocable_impl_, F, I1, I2);
/// \endcond
/// \concept indirect_unary_predicate_
/// \brief The \c indirect_unary_predicate_ concept
template(typename F, typename I)(
concept (indirect_unary_predicate_)(F, I),
predicate<F &, iter_value_t<I> &> AND
predicate<F &, iter_reference_t<I>> AND
predicate<F &, iter_common_reference_t<I>>
);
/// \concept indirect_unary_predicate
/// \brief The \c indirect_unary_predicate concept
template<typename F, typename I>
CPP_concept indirect_unary_predicate =
indirectly_readable<I> &&
copy_constructible<F> &&
CPP_concept_ref(ranges::indirect_unary_predicate_, F, I);
/// \concept indirect_binary_predicate_impl_
/// \brief The \c indirect_binary_predicate_impl_ concept
template(typename F, typename I1, typename I2)(
concept (indirect_binary_predicate_impl_)(F, I1, I2),
predicate<F &, iter_value_t<I1> &, iter_value_t<I2> &> AND
predicate<F &, iter_value_t<I1> &, iter_reference_t<I2>> AND
predicate<F &, iter_reference_t<I1>, iter_value_t<I2> &> AND
predicate<F &, iter_reference_t<I1>, iter_reference_t<I2>> AND
predicate<F &, iter_common_reference_t<I1>, iter_common_reference_t<I2>>
);
/// \concept indirect_binary_predicate_
/// \brief The \c indirect_binary_predicate_ concept
template<typename F, typename I1, typename I2>
CPP_concept indirect_binary_predicate_ =
indirectly_readable<I1> && indirectly_readable<I2> &&
copy_constructible<F> &&
CPP_concept_ref(ranges::indirect_binary_predicate_impl_, F, I1, I2);
/// \concept indirect_relation_
/// \brief The \c indirect_relation_ concept
template(typename F, typename I1, typename I2)(
concept (indirect_relation_)(F, I1, I2),
relation<F &, iter_value_t<I1> &, iter_value_t<I2> &> AND
relation<F &, iter_value_t<I1> &, iter_reference_t<I2>> AND
relation<F &, iter_reference_t<I1>, iter_value_t<I2> &> AND
relation<F &, iter_reference_t<I1>, iter_reference_t<I2>> AND
relation<F &, iter_common_reference_t<I1>, iter_common_reference_t<I2>>
);
/// \concept indirect_relation
/// \brief The \c indirect_relation concept
template<typename F, typename I1, typename I2 = I1>
CPP_concept indirect_relation =
indirectly_readable<I1> && indirectly_readable<I2> &&
copy_constructible<F> &&
CPP_concept_ref(ranges::indirect_relation_, F, I1, I2);
/// \concept indirect_strict_weak_order_
/// \brief The \c indirect_strict_weak_order_ concept
template(typename F, typename I1, typename I2)(
concept (indirect_strict_weak_order_)(F, I1, I2),
strict_weak_order<F &, iter_value_t<I1> &, iter_value_t<I2> &> AND
strict_weak_order<F &, iter_value_t<I1> &, iter_reference_t<I2>> AND
strict_weak_order<F &, iter_reference_t<I1>, iter_value_t<I2> &> AND
strict_weak_order<F &, iter_reference_t<I1>, iter_reference_t<I2>> AND
strict_weak_order<F &, iter_common_reference_t<I1>, iter_common_reference_t<I2>>
);
/// \concept indirect_strict_weak_order
/// \brief The \c indirect_strict_weak_order concept
template<typename F, typename I1, typename I2 = I1>
CPP_concept indirect_strict_weak_order =
indirectly_readable<I1> && indirectly_readable<I2> &&
copy_constructible<F> &&
CPP_concept_ref(ranges::indirect_strict_weak_order_, F, I1, I2);
// clang-format on
//////////////////////////////////////////////////////////////////////////////////////
// projected struct, for "projecting" a readable with a unary callable
/// \cond
namespace detail
{
RANGES_DIAGNOSTIC_PUSH
RANGES_DIAGNOSTIC_IGNORE_UNDEFINED_INTERNAL
template<typename I, typename Proj>
struct projected_
{
struct type
{
using reference = indirect_result_t<Proj &, I>;
using value_type = uncvref_t<reference>;
reference operator*() const;
};
};
RANGES_DIAGNOSTIC_POP
template<typename Proj>
struct select_projected_
{
template<typename I>
using apply =
meta::_t<
detail::enable_if_t<
(bool)indirectly_regular_unary_invocable<Proj, I>,
detail::projected_<I, Proj>>>;
};
template<>
struct select_projected_<identity>
{
template<typename I>
using apply = detail::enable_if_t<(bool)indirectly_readable<I>, I>;
};
} // namespace detail
/// \endcond
template<typename I, typename Proj>
using projected = typename detail::select_projected_<Proj>::template apply<I>;
template<typename I, typename Proj>
struct incrementable_traits<detail::projected_<I, Proj>> : incrementable_traits<I>
{};
// clang-format off
/// \concept indirectly_movable_
/// \brief The \c indirectly_movable_ concept
template(typename I, typename O)(
concept (indirectly_movable_)(I, O),
indirectly_writable<O, iter_rvalue_reference_t<I>>
);
/// \concept indirectly_movable
/// \brief The \c indirectly_movable concept
template<typename I, typename O>
CPP_concept indirectly_movable =
indirectly_readable<I> && CPP_concept_ref(ranges::indirectly_movable_, I, O);
/// \concept indirectly_movable_storable_
/// \brief The \c indirectly_movable_storable_ concept
template(typename I, typename O)(
concept (indirectly_movable_storable_)(I, O),
indirectly_writable<O, iter_value_t<I>> AND
movable<iter_value_t<I>> AND
constructible_from<iter_value_t<I>, iter_rvalue_reference_t<I>> AND
assignable_from<iter_value_t<I> &, iter_rvalue_reference_t<I>>
);
/// \concept indirectly_movable_storable
/// \brief The \c indirectly_movable_storable concept
template<typename I, typename O>
CPP_concept indirectly_movable_storable =
indirectly_movable<I, O> &&
CPP_concept_ref(ranges::indirectly_movable_storable_, I, O);
/// \concept indirectly_copyable_
/// \brief The \c indirectly_copyable_ concept
template(typename I, typename O)(
concept (indirectly_copyable_)(I, O),
indirectly_writable<O, iter_reference_t<I>>
);
/// \concept indirectly_copyable
/// \brief The \c indirectly_copyable concept
template<typename I, typename O>
CPP_concept indirectly_copyable =
indirectly_readable<I> && CPP_concept_ref(ranges::indirectly_copyable_, I, O);
/// \concept indirectly_copyable_storable_
/// \brief The \c indirectly_copyable_storable_ concept
template(typename I, typename O)(
concept (indirectly_copyable_storable_)(I, O),
indirectly_writable<O, iter_value_t<I> const &> AND
copyable<iter_value_t<I>> AND
constructible_from<iter_value_t<I>, iter_reference_t<I>> AND
assignable_from<iter_value_t<I> &, iter_reference_t<I>>
);
/// \concept indirectly_copyable_storable
/// \brief The \c indirectly_copyable_storable concept
template<typename I, typename O>
CPP_concept indirectly_copyable_storable =
indirectly_copyable<I, O> &&
CPP_concept_ref(ranges::indirectly_copyable_storable_, I, O);
/// \concept indirectly_swappable_
/// \brief The \c indirectly_swappable_ concept
template<typename I1, typename I2>
CPP_requires(indirectly_swappable_,
requires(I1 const i1, I2 const i2) //
(
ranges::iter_swap(i1, i2),
ranges::iter_swap(i1, i1),
ranges::iter_swap(i2, i2),
ranges::iter_swap(i2, i1)
));
/// \concept indirectly_swappable
/// \brief The \c indirectly_swappable concept
template<typename I1, typename I2 = I1>
CPP_concept indirectly_swappable =
indirectly_readable<I1> && //
indirectly_readable<I2> && //
CPP_requires_ref(ranges::indirectly_swappable_, I1, I2);
/// \concept projected_indirect_relation_
/// \brief The \c projected_indirect_relation_ concept
template(typename C, typename I1, typename P1, typename I2, typename P2)(
concept (projected_indirect_relation_)(C, I1, P1, I2, P2),
indirect_relation<C, projected<I1, P1>, projected<I2, P2>>
);
/// \concept indirectly_comparable
/// \brief The \c indirectly_comparable concept
template<typename I1, typename I2, typename C, typename P1 = identity,
typename P2 = identity>
CPP_concept indirectly_comparable =
CPP_concept_ref(ranges::projected_indirect_relation_, C, I1, P1, I2, P2);
//////////////////////////////////////////////////////////////////////////////////////
// Composite concepts for use defining algorithms:
/// \concept permutable
/// \brief The \c permutable concept
template<typename I>
CPP_concept permutable =
forward_iterator<I> &&
indirectly_swappable<I, I> &&
indirectly_movable_storable<I, I>;
/// \concept projected_indirect_strict_weak_order_
/// \brief The \c projected_indirect_strict_weak_order_ concept
template(typename C, typename I1, typename P1, typename I2, typename P2)(
concept (projected_indirect_strict_weak_order_)(C, I1, P1, I2, P2),
indirect_strict_weak_order<C, projected<I1, P1>, projected<I2, P2>>
);
template<typename I1, typename I2, typename Out, typename C = less,
typename P1 = identity, typename P2 = identity>
CPP_concept mergeable =
input_iterator<I1> &&
input_iterator<I2> &&
weakly_incrementable<Out> &&
indirectly_copyable<I1, Out> &&
indirectly_copyable<I2, Out> &&
CPP_concept_ref(ranges::projected_indirect_strict_weak_order_, C, I1, P1, I2, P2);
/// \concept sortable
/// \brief The \c sortable concept
template<typename I, typename C = less, typename P = identity>
CPP_concept sortable =
permutable<I> &&
CPP_concept_ref(ranges::projected_indirect_strict_weak_order_, C, I, P, I, P);
// clang-format on
struct sentinel_tag
{};
struct sized_sentinel_tag : sentinel_tag
{};
template<typename S, typename I>
using sentinel_tag_of = //
std::enable_if_t< //
sentinel_for<S, I>, //
meta::conditional_t< //
sized_sentinel_for<S, I>, //
sized_sentinel_tag, //
sentinel_tag>>;
// Deprecated things:
/// \cond
template<typename I>
using iterator_category RANGES_DEPRECATED(
"iterator_category is deprecated. Use the iterator concepts instead") =
detail::iterator_category<I>;
template<typename I>
using iterator_category_t RANGES_DEPRECATED(
"iterator_category_t is deprecated. Use the iterator concepts instead") =
meta::_t<detail::iterator_category<I>>;
template<typename Fun, typename... Is>
using indirect_invoke_result_t RANGES_DEPRECATED(
"Please switch to indirect_result_t") = indirect_result_t<Fun, Is...>;
template<typename Fun, typename... Is>
struct RANGES_DEPRECATED("Please switch to indirect_result_t") indirect_invoke_result
: meta::defer<indirect_result_t, Fun, Is...>
{};
template<typename Sig>
struct indirect_result_of
{};
template<typename Fun, typename... Is>
struct RANGES_DEPRECATED("Please switch to indirect_result_t")
indirect_result_of<Fun(Is...)> : meta::defer<indirect_result_t, Fun, Is...>
{};
template<typename Sig>
using indirect_result_of_t RANGES_DEPRECATED("Please switch to indirect_result_t") =
meta::_t<indirect_result_of<Sig>>;
/// \endcond
namespace cpp20
{
using ranges::bidirectional_iterator;
using ranges::contiguous_iterator;
using ranges::forward_iterator;
using ranges::incrementable;
using ranges::indirect_relation;
using ranges::indirect_result_t;
using ranges::indirect_strict_weak_order;
using ranges::indirect_unary_predicate;
using ranges::indirectly_comparable;
using ranges::indirectly_copyable;
using ranges::indirectly_copyable_storable;
using ranges::indirectly_movable;
using ranges::indirectly_movable_storable;
using ranges::indirectly_readable;
using ranges::indirectly_regular_unary_invocable;
using ranges::indirectly_swappable;
using ranges::indirectly_unary_invocable;
using ranges::indirectly_writable;
using ranges::input_iterator;
using ranges::input_or_output_iterator;
using ranges::mergeable;
using ranges::output_iterator;
using ranges::permutable;
using ranges::projected;
using ranges::random_access_iterator;
using ranges::sentinel_for;
using ranges::sized_sentinel_for;
using ranges::sortable;
using ranges::weakly_incrementable;
} // namespace cpp20
/// @}
} // namespace ranges
#ifdef _GLIBCXX_DEBUG
// HACKHACK: workaround underconstrained operator- for libstdc++ debug iterator wrapper
// by intentionally creating an ambiguity when the wrapped types don't support the
// necessary operation.
namespace __gnu_debug
{
template(typename I1, typename I2, typename Seq)(
requires (!::ranges::sized_sentinel_for<I1, I2>)) //
void operator-(_Safe_iterator<I1, Seq> const &, _Safe_iterator<I2, Seq> const &) =
delete;
template(typename I1, typename Seq)(
requires (!::ranges::sized_sentinel_for<I1, I1>)) //
void operator-(_Safe_iterator<I1, Seq> const &, _Safe_iterator<I1, Seq> const &) =
delete;
} // namespace __gnu_debug
#endif
#if defined(__GLIBCXX__) || (defined(_LIBCPP_VERSION) && _LIBCPP_VERSION <= 3900)
// HACKHACK: workaround libc++ (https://llvm.org/bugs/show_bug.cgi?id=28421)
// and libstdc++ (https://gcc.gnu.org/bugzilla/show_bug.cgi?id=71771)
// underconstrained operator- for reverse_iterator by disabling sized_sentinel_for
// when the base iterators do not model sized_sentinel_for.
namespace ranges
{
template<typename S, typename I>
/*inline*/ constexpr bool
disable_sized_sentinel<std::reverse_iterator<S>, std::reverse_iterator<I>> =
!static_cast<bool>(sized_sentinel_for<I, S>);
} // namespace ranges
#endif // defined(__GLIBCXX__) || (defined(_LIBCPP_VERSION) && _LIBCPP_VERSION <= 3900)
#include <range/v3/detail/epilogue.hpp>
#endif // RANGES_V3_ITERATOR_CONCEPTS_HPP