folly/functional/Invoke.h

   1 /*
   2  * Copyright 2017-present Facebook, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *   http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #pragma once
  18
  19 #include <functional>
  20 #include <type_traits>
  21
  22 #include <folly/Traits.h>
  23
  24 /**
  25  *  include or backport:
  26  *  * std::invoke
  27  *  * std::invoke_result
  28  *  * std::invoke_result_t
  29  *  * std::is_invocable
  30  *  * std::is_invocable_r
  31  *  * std::is_nothrow_invocable
  32  *  * std::is_nothrow_invocable_r
  33  */
  34
  35 #if __cpp_lib_invoke >= 201411 || _MSC_VER
  36
  37 namespace folly {
  38
  39 /* using override */ using std::invoke;
  40
  41 }
  42
  43 #else
  44
  45 namespace folly {
  46
  47 //  mimic: std::invoke, C++17
  48 template <typename F, typename... Args>
  49 constexpr auto invoke(F&& f, Args&&... args) noexcept(
  50     noexcept(std::forward<F>(f)(std::forward<Args>(args)...)))
  51     -> decltype(std::forward<F>(f)(std::forward<Args>(args)...)) {
  52   return std::forward<F>(f)(std::forward<Args>(args)...);
  53 }
  54 template <typename M, typename C, typename... Args>
  55 constexpr auto invoke(M(C::*d), Args&&... args)
  56     -> decltype(std::mem_fn(d)(std::forward<Args>(args)...)) {
  57   return std::mem_fn(d)(std::forward<Args>(args)...);
  58 }
  59
  60 } // namespace folly
  61
  62 #endif
  63
  64 // Only available in >= MSVC 2017 15.3
  65 #if __cpp_lib_is_invocable >= 201703 || _MSC_VER >= 1911
  66
  67 namespace folly {
  68
  69 /* using override */ using std::invoke_result;
  70 /* using override */ using std::invoke_result_t;
  71 /* using override */ using std::is_invocable;
  72 /* using override */ using std::is_invocable_r;
  73 /* using override */ using std::is_nothrow_invocable;
  74 /* using override */ using std::is_nothrow_invocable_r;
  75
  76 }
  77
  78 #else
  79
  80 namespace folly {
  81
  82 namespace detail {
  83
  84 template <typename F, typename... Args>
  85 using invoke_result_ =
  86     decltype(invoke(std::declval<F>(), std::declval<Args>()...));
  87
  88 template <typename F, typename... Args>
  89 using invoke_nothrow_ = std::integral_constant<
  90     bool,
  91     noexcept(invoke(std::declval<F>(), std::declval<Args>()...))>;
  92
  93 //  from: http://en.cppreference.com/w/cpp/types/result_of, CC-BY-SA
  94
  95 template <typename Void, typename F, typename... Args>
  96 struct invoke_result {};
  97
  98 template <typename F, typename... Args>
  99 struct invoke_result<void_t<invoke_result_<F, Args...>>, F, Args...> {
 100   using type = invoke_result_<F, Args...>;
 101 };
 102
 103 template <typename Void, typename F, typename... Args>
 104 struct is_invocable : std::false_type {};
 105
 106 template <typename F, typename... Args>
 107 struct is_invocable<void_t<invoke_result_<F, Args...>>, F, Args...>
 108     : std::true_type {};
 109
 110 template <typename Void, typename R, typename F, typename... Args>
 111 struct is_invocable_r : std::false_type {};
 112
 113 template <typename R, typename F, typename... Args>
 114 struct is_invocable_r<void_t<invoke_result_<F, Args...>>, R, F, Args...>
 115     : std::is_convertible<invoke_result_<F, Args...>, R> {};
 116
 117 template <typename Void, typename F, typename... Args>
 118 struct is_nothrow_invocable : std::false_type {};
 119
 120 template <typename F, typename... Args>
 121 struct is_nothrow_invocable<void_t<invoke_result_<F, Args...>>, F, Args...>
 122     : invoke_nothrow_<F, Args...> {};
 123
 124 template <typename Void, typename R, typename F, typename... Args>
 125 struct is_nothrow_invocable_r : std::false_type {};
 126
 127 template <typename R, typename F, typename... Args>
 128 struct is_nothrow_invocable_r<void_t<invoke_result_<F, Args...>>, R, F, Args...>
 129     : StrictConjunction<
 130         std::is_convertible<invoke_result_<F, Args...>, R>,
 131         invoke_nothrow_<F, Args...>> {};
 132
 133 } // namespace detail
 134
 135 //  mimic: std::invoke_result, C++17
 136 template <typename F, typename... Args>
 137 struct invoke_result : detail::invoke_result<void, F, Args...> {};
 138
 139 //  mimic: std::invoke_result_t, C++17
 140 template <typename F, typename... Args>
 141 using invoke_result_t = typename invoke_result<F, Args...>::type;
 142
 143 //  mimic: std::is_invocable, C++17
 144 template <typename F, typename... Args>
 145 struct is_invocable : detail::is_invocable<void, F, Args...> {};
 146
 147 //  mimic: std::is_invocable_r, C++17
 148 template <typename R, typename F, typename... Args>
 149 struct is_invocable_r : detail::is_invocable_r<void, R, F, Args...> {};
 150
 151 //  mimic: std::is_nothrow_invocable, C++17
 152 template <typename F, typename... Args>
 153 struct is_nothrow_invocable : detail::is_nothrow_invocable<void, F, Args...> {};
 154
 155 //  mimic: std::is_nothrow_invocable_r, C++17
 156 template <typename R, typename F, typename... Args>
 157 struct is_nothrow_invocable_r
 158     : detail::is_nothrow_invocable_r<void, R, F, Args...> {};
 159
 160 } // namespace folly
 161
 162 #endif