Namespaces
Variants

std:: indirectly_unary_invocable, std:: indirectly_regular_unary_invocable

From cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
indirectly_unary_invocable indirectly_regular_unary_invocable
(C++20) (C++20)
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
Défini dans l'en-tête <iterator>
std::indirectly_unary_invocable
template < class F, class I >

concept indirectly_unary_invocable =
std:: indirectly_readable < I > &&
std:: copy_constructible < F > &&
std:: invocable < F & , /*indirect-value-t*/ < I >> &&
std:: invocable < F & , std:: iter_reference_t < I >> &&
std:: common_reference_with <
std:: invoke_result_t < F & , /*indirect-value-t*/ < I >> ,

std:: invoke_result_t < F & , std:: iter_reference_t < I >>> ;
(depuis C++20)
std::indirectly_regular_unary_invocable
template < class F, class I >

concept indirectly_regular_unary_invocable =
std:: indirectly_readable < I > &&
std:: copy_constructible < F > &&
std:: regular_invocable < F & , /*indirect-value-t*/ < I >> &&
std:: regular_invocable < F & , std:: iter_reference_t < I >> &&
std:: common_reference_with <
std:: invoke_result_t < F & , /*indirect-value-t*/ < I >> ,

std:: invoke_result_t < F & , std:: iter_reference_t < I >>> ;
(depuis C++20)

Les concepts indirectly_unary_invocable et indirectly_regular_unary_invocable spécifient les exigences pour les algorithmes qui appellent des invocables unaires (réguliers) comme arguments. La différence principale entre ces concepts et std::invocable est qu'ils s'appliquent au type référencé par I , plutôt qu'à I lui-même.

Notes

La distinction entre indirectly_unary_invocable et indirectly_regular_unary_invocable est purement sémantique.

Exemple

#include <algorithm>
#include <iterator>
#include <print>
#include <ranges>
struct IntWrapper
{
    int i;
    explicit IntWrapper(int i) : i(i) {}
    IntWrapper(IntWrapper&&) = default;
    IntWrapper& operator=(IntWrapper&&) = default;
};
int main()
{
    auto ints  = std::views::iota(1, 10);
    auto print = [] (IntWrapper w) { std::print("{} ", w.i); };
    auto wrap  = [] (int i) { return IntWrapper{i}; };
    using Proj = std::projected<decltype(ints.begin()), decltype(wrap)>;
    // erreur (évalué à false) jusqu'à P2609R3 :
    // ceci était dû au fait que 'std::iter_value_t<Proj> &' est identique à 'IntWrapper&'
    // qui n'est pas convertible en 'IntWrapper' (constructeur de copie implicitement supprimé)
    static_assert(std::indirectly_unary_invocable<decltype(print), Proj>);
    // si la vérification à la compilation ci-dessus s'évalue à true, alors ceci est bien formé :
    std::ranges::for_each(ints, print, wrap);
}

Sortie :

1 2 3 4 5 6 7 8 9

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

DR Appliqué à Comportement publié Comportement corrigé
P2609R3 C++20 certaines exigences étaient définies en termes de std:: iter_value_t < I > &
ce qui gérait incorrectement les projections, entraînant une incompatibilité avec invocable F &
défini en termes de /*indirect-value-t*/ < I >
pour gérer correctement ces projections
P2997R1 C++20 les concepts correspondants exigeaient que F & satisfasse invocable et
regular_invocable , respectivement, avec std:: iter_common_reference_t < I >
n'exige pas