Namespaces
Variants

std:: result_of, std:: invoke_result

From cppreference.net
Metaprogramming library
Type traits
Type categories
(C++11)
(C++11) ( DR* )
Type properties
(C++11)
(C++11)
(C++14)
(C++11) (deprecated in C++26)
(C++11) ( until C++20* )
(C++11) (deprecated in C++20)
(C++11)
Type trait constants
Metafunctions
(C++17)
Supported operations
Relationships and property queries
Type modifications
Type transformations
(C++11) (deprecated in C++23)
(C++11) (deprecated in C++23)
(C++11)
result_of invoke_result
(C++11) ( until C++20* ) (C++17)

Compile-time rational arithmetic
Compile-time integer sequences
Определено в заголовочном файле <type_traits>
template < class >

class result_of ; // не определен

template < class F, class ... ArgTypes >

class result_of < F ( ArgTypes... ) > ;
(1) (начиная с C++11)
(устарело в C++17)
(удалено в C++20)
template < class F, class ... ArgTypes >
class invoke_result ;
(2) (начиная с C++17)

Выводит тип возвращаемого значения INVOKE выражения на этапе компиляции.

F должен быть вызываемым типом, ссылкой на функцию или ссылкой на вызываемый тип. Вызов F с ArgTypes... должен быть корректным выражением.

(since C++11)
(until C++14)

F и все типы в ArgTypes могут быть любыми полными типами, массивами неизвестной границы или (возможно cv-квалифицированным) void .

(since C++14)

Если программа добавляет специализации для любых шаблонов, описанных на этой странице, поведение не определено.

Содержание

Типы членов

Тип члена Определение
type возвращаемый тип Callable типа F при вызове с аргументами ArgTypes... . Определяется только если F может быть вызван с аргументами ArgTypes... в невычисляемом контексте. (начиная с C++14)

Вспомогательные типы

template < class T >
using result_of_t = typename result_of < T > :: type ;
(1) (начиная с C++14)
(устарело в C++17)
(удалено в C++20)
template < class F, class ... ArgTypes >
using invoke_result_t = typename invoke_result < F, ArgTypes... > :: type ;
(2) (начиная с C++17)

Возможная реализация

namespace detail
{
    template<class T>
    struct is_reference_wrapper : std::false_type {};
    template<class U>
    struct is_reference_wrapper<std::reference_wrapper<U>> : std::true_type {};
    template<class T>
    struct invoke_impl
    {
        template<class F, class... Args>
        static auto call(F&& f, Args&&... args)
            -> decltype(std::forward<F>(f)(std::forward<Args>(args)...));
    };
    template<class B, class MT>
    struct invoke_impl<MT B::*>
    {
        template<class T, class Td = typename std::decay<T>::type,
            class = typename std::enable_if<std::is_base_of<B, Td>::значение>::type>
        static auto get(T&& t) -> T&&;
        template<class T, class Td = typename std::decay<T>::type,
            class = typename std::enable_if<is_reference_wrapper<Td>::значение>::type>
        static auto get(T&& t) -> decltype(t.get());
        template<class T, class Td = typename std::decay<T>::type,
            class = typename std::enable_if<!std::is_base_of<B, Td>::значение>::type,
            class = typename std::enable_if<!is_reference_wrapper<Td>::значение>::type>
        static auto get(T&& t) -> decltype(*std::forward<T>(t));
        template<class T, class... Args, class MT1,
            class = typename std::enable_if<std::is_function<MT1>::значение>::type>
        static auto call(MT1 B::*pmf, T&& t, Args&&... args)
            -> decltype((invoke_impl::get(
                std::forward<T>(t)).*pmf)(std::forward<Args>(args)...));
        template<class T>
        static auto call(MT B::*pmd, T&& t)
            -> decltype(invoke_impl::get(std::forward<T>(t)).*pmd);
    };
    template<class F, class... Args, class Fd = typename std::decay<F>::type>
    auto INVOKE(F&& f, Args&&... args)
        -> decltype(invoke_impl<Fd>::вызов(std::forward<F>(f),
            std::forward<Args>(args)...));
} // namespace detail
// Минимальная реализация на C++11:
template<class> struct result_of;
template<class F, class... ArgTypes>
struct result_of<F(ArgTypes...)>
{
    using type = decltype(detail::INVOKE(std::declval<F>(), std::declval<ArgTypes>()...));
};
// Соответствующая реализация C++14 (также является корректной реализацией C++11):
namespace detail
{
    template<typename AlwaysVoid, typename, typename...>
    struct invoke_result {};
    template<typename F, typename...Args>
    struct invoke_result<
        decltype(void(detail::INVOKE(std::declval<F>(), std::declval<Args>()...))),
            F, Args...>
    {
        using type = decltype(detail::INVOKE(std::declval<F>(), std::declval<Args>()...));
    };
} // namespace detail
template<class> struct result_of;
template<class F, class... ArgTypes>
struct result_of<F(ArgTypes...)> : detail::invoke_result<void, F, ArgTypes...> {};
template<class F, class... ArgTypes>
struct invoke_result : detail::invoke_result<void, F, ArgTypes...> {};

Примечания

Как сформулировано в C++11, поведение std::result_of не определено, когда INVOKE(std::declval<F>(), std::declval<ArgTypes>()...) является некорректным выражением (например, когда F вообще не является вызываемым типом). C++14 изменяет это на SFINAE (когда F не является вызываемым, std::result_of<F(ArgTypes...)> просто не имеет члена type ).

Мотивация для введения std::result_of заключается в определении результата вызова Callable , особенно когда этот тип результата различается для разных наборов аргументов.

F ( Args... ) представляет собой тип функции, где Args... являются типами аргументов, а F - возвращаемым типом. Таким образом, std::result_of обладает рядом особенностей, которые привели к его устареванию в пользу std::invoke_result в C++17:

  • F не может быть типом функции или типом массива (но может быть ссылкой на них);
  • если любой из Args имеет тип "массив T " или тип функции T , он автоматически преобразуется в T* ;
  • ни F , ни любой из Args... не может быть типом абстрактного класса;
  • если любой из Args... имеет cv-квалификатор верхнего уровня, он отбрасывается;
  • ни один из Args... не может быть типа void .

Чтобы избежать этих особенностей, result_of часто используется с ссылочными типами для F и Args... . Например:

template<class F, class... Args>
std::result_of_t<F&&(Args&&...)> // вместо std::result_of_t<F(Args...)>, что является неверным
    my_invoke(F&& f, Args&&... args)
    {
        /* реализация */
    }

Примечания

Макрос тестирования возможностей Значение Стандарт Функция
__cpp_lib_result_of_sfinae 201210L (C++14) std::result_of и SFINAE
__cpp_lib_is_invocable 201703L (C++17) std::is_invocable , std::invoke_result

Примеры

#include <iostream>
#include <type_traits>
struct S
{
    double operator()(char, int&);
    float operator()(int) { return 1.0; }
};
template<class T>
typename std::result_of<T(int)>::type f(T& t)
{
    std::cout << "overload of f for callable T\n";
    return t(0);
}
template<class T, class U>
int f(U u)
{
    std::cout << "overload of f for non-callable T\n";
    return u;
}
int main()
{
    // результат вызова S с аргументами char и int& - это double
    std::result_of<S(char, int&)>::type d = 3.14; // d имеет тип double
    static_assert(std::is_same<decltype(d), double>::value, "");
    // std::invoke_result использует другой синтаксис (без скобок)
    std::invoke_result<S,char,int&>::type b = 3.14;
    static_assert(std::is_same<decltype(b), double>::value, "");
    // результат вызова S с аргументом int - это float
    std::result_of<S(int)>::type x = 3.14; // x имеет тип float
    static_assert(std::is_same<decltype(x), float>::value, "");
    // result_of может быть использован с указателем на функцию-член следующим образом
    struct C { double Func(char, int&); };
    std::result_of<decltype(&C::Func)(C, char, int&)>::type g = 3.14;
    static_assert(std::is_same<decltype(g), double>::value, "");
    f<C>(1); // может не скомпилироваться в C++11; вызывает перегрузку для невызываемых типов в C++14
}

Вывод:

overload of f for non-callable T

Смотрите также

(C++17) (C++23)
вызывает любой Callable объект с заданными аргументами с возможностью указания типа возвращаемого значения (since C++23)
(шаблон функции)
проверяет, может ли тип быть вызван (как с помощью std::invoke ) с заданными типами аргументов
(шаблон класса)
(C++11)
получает ссылку на объект шаблонного типа аргумента для использования в невычисляемом контексте
(шаблон функции)