1 //===----------------------------------------------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 // UNSUPPORTED: c++03, c++11, c++14, c++17
10 // UNSUPPORTED: libcpp-no-concepts
11 
12 // template<class T, class U>
13 // concept invocable;
14 
15 #include <chrono>
16 #include <concepts>
17 #include <memory>
18 #include <random>
19 #include <type_traits>
20 
21 template <class R, class... Args>
22 constexpr bool check_invocable() {
23   constexpr bool result = std::invocable<R(Args...), Args...>;
24   static_assert(std::invocable<R(Args...) noexcept, Args...> == result);
25   static_assert(std::invocable<R (*)(Args...), Args...> == result);
26   static_assert(std::invocable<R (*)(Args...) noexcept, Args...> == result);
27   static_assert(std::invocable<R (&)(Args...), Args...> == result);
28   static_assert(std::invocable<R (&)(Args...) noexcept, Args...> == result);
29 
30   return result;
31 }
32 
33 static_assert(check_invocable<void>());
34 static_assert(check_invocable<void, int>());
35 static_assert(check_invocable<void, int&>());
36 static_assert(check_invocable<void, int*, double>());
37 static_assert(check_invocable<int>());
38 static_assert(check_invocable<int, int[]>());
39 
40 struct S;
41 static_assert(check_invocable<int, int S::*, std::nullptr_t>());
42 static_assert(check_invocable<int, int (S::*)(), int (S::*)(int), int>());
43 static_assert(std::invocable<void (*)(int const&), int&>);
44 static_assert(std::invocable<void (*)(int const&), int&&>);
45 static_assert(std::invocable<void (*)(int volatile&), int&>);
46 static_assert(std::invocable<void (*)(int const volatile&), int&>);
47 
48 static_assert(!std::invocable<void(), int>);
49 static_assert(!std::invocable<void(int)>);
50 static_assert(!std::invocable<void(int*), double*>);
51 static_assert(!std::invocable<void (*)(int&), double*>);
52 static_assert(std::invocable<int S::*, std::unique_ptr<S> >);
53 static_assert(std::invocable<int S::*, std::shared_ptr<S> >);
54 static_assert(!std::invocable<void (*)(int&&), int&>);
55 static_assert(!std::invocable<void (*)(int&&), int const&>);
56 
57 static_assert(!std::invocable<void>);
58 static_assert(!std::invocable<void*>);
59 static_assert(!std::invocable<int>);
60 static_assert(!std::invocable<int&>);
61 static_assert(!std::invocable<int&&>);
62 
63 namespace function_objects {
64 struct function_object {
65   void operator()();
66 };
67 static_assert(std::invocable<function_object>);
68 static_assert(!std::invocable<function_object const>);
69 static_assert(!std::invocable<function_object volatile>);
70 static_assert(!std::invocable<function_object const volatile>);
71 static_assert(std::invocable<function_object&>);
72 static_assert(!std::invocable<function_object const&>);
73 static_assert(!std::invocable<function_object volatile&>);
74 static_assert(!std::invocable<function_object const volatile&>);
75 
76 struct const_function_object {
77   void operator()(int) const;
78 };
79 static_assert(std::invocable<const_function_object, int>);
80 static_assert(std::invocable<const_function_object const, int>);
81 static_assert(!std::invocable<const_function_object volatile, int>);
82 static_assert(!std::invocable<const_function_object const volatile, int>);
83 static_assert(std::invocable<const_function_object&, int>);
84 static_assert(std::invocable<const_function_object const&, int>);
85 static_assert(!std::invocable<const_function_object volatile&, int>);
86 static_assert(!std::invocable<const_function_object const volatile&, int>);
87 
88 struct volatile_function_object {
89   void operator()(int, int) volatile;
90 };
91 static_assert(std::invocable<volatile_function_object, int, int>);
92 static_assert(!std::invocable<volatile_function_object const, int, int>);
93 static_assert(std::invocable<volatile_function_object volatile, int, int>);
94 static_assert(
95     !std::invocable<volatile_function_object const volatile, int, int>);
96 static_assert(std::invocable<volatile_function_object&, int, int>);
97 static_assert(!std::invocable<volatile_function_object const&, int, int>);
98 static_assert(std::invocable<volatile_function_object volatile&, int, int>);
99 static_assert(
100     !std::invocable<volatile_function_object const volatile&, int, int>);
101 
102 struct cv_function_object {
103   void operator()(int[]) const volatile;
104 };
105 static_assert(std::invocable<cv_function_object, int*>);
106 static_assert(std::invocable<cv_function_object const, int*>);
107 static_assert(std::invocable<cv_function_object volatile, int*>);
108 static_assert(std::invocable<cv_function_object const volatile, int*>);
109 static_assert(std::invocable<cv_function_object&, int*>);
110 static_assert(std::invocable<cv_function_object const&, int*>);
111 static_assert(std::invocable<cv_function_object volatile&, int*>);
112 static_assert(std::invocable<cv_function_object const volatile&, int*>);
113 
114 struct lvalue_function_object {
115   void operator()() &;
116 };
117 static_assert(!std::invocable<lvalue_function_object>);
118 static_assert(!std::invocable<lvalue_function_object const>);
119 static_assert(!std::invocable<lvalue_function_object volatile>);
120 static_assert(!std::invocable<lvalue_function_object const volatile>);
121 static_assert(std::invocable<lvalue_function_object&>);
122 static_assert(!std::invocable<lvalue_function_object const&>);
123 static_assert(!std::invocable<lvalue_function_object volatile&>);
124 static_assert(!std::invocable<lvalue_function_object const volatile&>);
125 
126 struct lvalue_const_function_object {
127   void operator()(int) const&;
128 };
129 static_assert(std::invocable<lvalue_const_function_object, int>);
130 static_assert(std::invocable<lvalue_const_function_object const, int>);
131 static_assert(!std::invocable<lvalue_const_function_object volatile, int>);
132 static_assert(
133     !std::invocable<lvalue_const_function_object const volatile, int>);
134 static_assert(std::invocable<lvalue_const_function_object&, int>);
135 static_assert(std::invocable<lvalue_const_function_object const&, int>);
136 static_assert(!std::invocable<lvalue_const_function_object volatile&, int>);
137 static_assert(
138     !std::invocable<lvalue_const_function_object const volatile&, int>);
139 
140 struct lvalue_volatile_function_object {
141   void operator()(int, int) volatile&;
142 };
143 static_assert(!std::invocable<lvalue_volatile_function_object, int, int>);
144 static_assert(!std::invocable<lvalue_volatile_function_object const, int, int>);
145 static_assert(
146     !std::invocable<lvalue_volatile_function_object volatile, int, int>);
147 static_assert(
148     !std::invocable<lvalue_volatile_function_object const volatile, int, int>);
149 static_assert(std::invocable<lvalue_volatile_function_object&, int, int>);
150 static_assert(
151     !std::invocable<lvalue_volatile_function_object const&, int, int>);
152 static_assert(
153     std::invocable<lvalue_volatile_function_object volatile&, int, int>);
154 static_assert(
155     !std::invocable<lvalue_volatile_function_object const volatile&, int, int>);
156 
157 struct lvalue_cv_function_object {
158   void operator()(int[]) const volatile&;
159 };
160 static_assert(!std::invocable<lvalue_cv_function_object, int*>);
161 static_assert(!std::invocable<lvalue_cv_function_object const, int*>);
162 static_assert(!std::invocable<lvalue_cv_function_object volatile, int*>);
163 static_assert(!std::invocable<lvalue_cv_function_object const volatile, int*>);
164 static_assert(std::invocable<lvalue_cv_function_object&, int*>);
165 static_assert(std::invocable<lvalue_cv_function_object const&, int*>);
166 static_assert(std::invocable<lvalue_cv_function_object volatile&, int*>);
167 static_assert(std::invocable<lvalue_cv_function_object const volatile&, int*>);
168 //
169 struct rvalue_function_object {
170   void operator()() &&;
171 };
172 static_assert(std::invocable<rvalue_function_object>);
173 static_assert(!std::invocable<rvalue_function_object const>);
174 static_assert(!std::invocable<rvalue_function_object volatile>);
175 static_assert(!std::invocable<rvalue_function_object const volatile>);
176 static_assert(!std::invocable<rvalue_function_object&>);
177 static_assert(!std::invocable<rvalue_function_object const&>);
178 static_assert(!std::invocable<rvalue_function_object volatile&>);
179 static_assert(!std::invocable<rvalue_function_object const volatile&>);
180 
181 struct rvalue_const_function_object {
182   void operator()(int) const&&;
183 };
184 static_assert(std::invocable<rvalue_const_function_object, int>);
185 static_assert(std::invocable<rvalue_const_function_object const, int>);
186 static_assert(!std::invocable<rvalue_const_function_object volatile, int>);
187 static_assert(
188     !std::invocable<rvalue_const_function_object const volatile, int>);
189 static_assert(!std::invocable<rvalue_const_function_object&, int>);
190 static_assert(!std::invocable<rvalue_const_function_object const&, int>);
191 static_assert(!std::invocable<rvalue_const_function_object volatile&, int>);
192 static_assert(
193     !std::invocable<rvalue_const_function_object const volatile&, int>);
194 
195 struct rvalue_volatile_function_object {
196   void operator()(int, int) volatile&&;
197 };
198 static_assert(std::invocable<rvalue_volatile_function_object, int, int>);
199 static_assert(!std::invocable<rvalue_volatile_function_object const, int, int>);
200 static_assert(
201     std::invocable<rvalue_volatile_function_object volatile, int, int>);
202 static_assert(
203     !std::invocable<rvalue_volatile_function_object const volatile, int, int>);
204 static_assert(!std::invocable<rvalue_volatile_function_object&, int, int>);
205 static_assert(
206     !std::invocable<rvalue_volatile_function_object const&, int, int>);
207 static_assert(
208     !std::invocable<rvalue_volatile_function_object volatile&, int, int>);
209 static_assert(
210     !std::invocable<rvalue_volatile_function_object const volatile&, int, int>);
211 
212 struct rvalue_cv_function_object {
213   void operator()(int[]) const volatile&&;
214 };
215 static_assert(std::invocable<rvalue_cv_function_object, int*>);
216 static_assert(std::invocable<rvalue_cv_function_object const, int*>);
217 static_assert(std::invocable<rvalue_cv_function_object volatile, int*>);
218 static_assert(std::invocable<rvalue_cv_function_object const volatile, int*>);
219 static_assert(!std::invocable<rvalue_cv_function_object&, int*>);
220 static_assert(!std::invocable<rvalue_cv_function_object const&, int*>);
221 static_assert(!std::invocable<rvalue_cv_function_object volatile&, int*>);
222 static_assert(!std::invocable<rvalue_cv_function_object const volatile&, int*>);
223 
224 struct multiple_overloads {
225   struct A {};
226   struct B { B(int); };
227   struct AB : A, B {};
228   struct O {};
229   void operator()(A) const;
230   void operator()(B) const;
231 };
232 static_assert(std::invocable<multiple_overloads, multiple_overloads::A>);
233 static_assert(std::invocable<multiple_overloads, multiple_overloads::B>);
234 static_assert(std::invocable<multiple_overloads, int>);
235 static_assert(!std::invocable<multiple_overloads, multiple_overloads::AB>);
236 static_assert(!std::invocable<multiple_overloads, multiple_overloads::O>);
237 } // namespace function_objects
238 
239 namespace pointer_to_member_functions {
240 // clang-format off
241   template<class Member, class T, class... Args>
242   constexpr bool check_member_is_invocable()
243   {
244     constexpr bool result = std::invocable<Member, T, Args...>;
245     using uncv_t = std::remove_cvref_t<T>;
246     static_assert(std::invocable<Member, uncv_t*, Args...> == result);
247     static_assert(std::invocable<Member, std::unique_ptr<uncv_t>, Args...> == result);
248     static_assert(std::invocable<Member, std::reference_wrapper<uncv_t>, Args...> == result);
249     static_assert(!std::invocable<Member, std::nullptr_t, Args...>);
250     static_assert(!std::invocable<Member, int, Args...>);
251     static_assert(!std::invocable<Member, int*, Args...>);
252     static_assert(!std::invocable<Member, double*, Args...>);
253     struct S2 {};
254     static_assert(!std::invocable<Member, S2*, Args...>);
255     return result;
256   }
257 // clang-format on
258 
259 static_assert(check_member_is_invocable<int S::*, S>());
260 static_assert(std::invocable<int S::*, S&>);
261 static_assert(std::invocable<int S::*, S const&>);
262 static_assert(std::invocable<int S::*, S volatile&>);
263 static_assert(std::invocable<int S::*, S const volatile&>);
264 static_assert(std::invocable<int S::*, S&&>);
265 static_assert(std::invocable<int S::*, S const&&>);
266 static_assert(std::invocable<int S::*, S volatile&&>);
267 static_assert(std::invocable<int S::*, S const volatile&&>);
268 
269 static_assert(check_member_is_invocable<int (S::*)(int), S, int>());
270 static_assert(!check_member_is_invocable<int (S::*)(int), S>());
271 using unqualified = void (S::*)();
272 static_assert(std::invocable<unqualified, S&>);
273 static_assert(!std::invocable<unqualified, S const&>);
274 static_assert(!std::invocable<unqualified, S volatile&>);
275 static_assert(!std::invocable<unqualified, S const volatile&>);
276 static_assert(std::invocable<unqualified, S&&>);
277 static_assert(!std::invocable<unqualified, S const&&>);
278 static_assert(!std::invocable<unqualified, S volatile&&>);
279 static_assert(!std::invocable<unqualified, S const volatile&&>);
280 
281 static_assert(check_member_is_invocable<int (S::*)(double) const, S, double>());
282 using const_qualified = void (S::*)() const;
283 static_assert(std::invocable<const_qualified, S&>);
284 static_assert(std::invocable<const_qualified, S const&>);
285 static_assert(!std::invocable<const_qualified, S volatile&>);
286 static_assert(!std::invocable<const_qualified, S const volatile&>);
287 static_assert(std::invocable<const_qualified, S&&>);
288 static_assert(std::invocable<const_qualified, S const&&>);
289 static_assert(!std::invocable<const_qualified, S volatile&&>);
290 static_assert(!std::invocable<const_qualified, S const volatile&&>);
291 
292 static_assert(
293     check_member_is_invocable<int (S::*)(double[]) volatile, S, double*>());
294 using volatile_qualified = void (S::*)() volatile;
295 static_assert(std::invocable<volatile_qualified, S&>);
296 static_assert(!std::invocable<volatile_qualified, S const&>);
297 static_assert(std::invocable<volatile_qualified, S volatile&>);
298 static_assert(!std::invocable<volatile_qualified, S const volatile&>);
299 static_assert(std::invocable<volatile_qualified, S&&>);
300 static_assert(!std::invocable<volatile_qualified, S const&&>);
301 static_assert(std::invocable<volatile_qualified, S volatile&&>);
302 static_assert(!std::invocable<volatile_qualified, S const volatile&&>);
303 
304 static_assert(check_member_is_invocable<int (S::*)(int, S&) const volatile, S,
305                                         int, S&>());
306 using cv_qualified = void (S::*)() const volatile;
307 static_assert(std::invocable<cv_qualified, S&>);
308 static_assert(std::invocable<cv_qualified, S const&>);
309 static_assert(std::invocable<cv_qualified, S volatile&>);
310 static_assert(std::invocable<cv_qualified, S const volatile&>);
311 static_assert(std::invocable<cv_qualified, S&&>);
312 static_assert(std::invocable<cv_qualified, S const&&>);
313 static_assert(std::invocable<cv_qualified, S volatile&&>);
314 static_assert(std::invocable<cv_qualified, S const volatile&&>);
315 
316 static_assert(check_member_is_invocable<int (S::*)() &, S&>());
317 using lvalue_qualified = void (S::*)() &;
318 static_assert(std::invocable<lvalue_qualified, S&>);
319 static_assert(!std::invocable<lvalue_qualified, S const&>);
320 static_assert(!std::invocable<lvalue_qualified, S volatile&>);
321 static_assert(!std::invocable<lvalue_qualified, S const volatile&>);
322 static_assert(!std::invocable<lvalue_qualified, S&&>);
323 static_assert(!std::invocable<lvalue_qualified, S const&&>);
324 static_assert(!std::invocable<lvalue_qualified, S volatile&&>);
325 static_assert(!std::invocable<lvalue_qualified, S const volatile&&>);
326 
327 static_assert(check_member_is_invocable<int (S::*)() const&, S>());
328 using lvalue_const_qualified = void (S::*)() const&;
329 static_assert(std::invocable<lvalue_const_qualified, S&>);
330 static_assert(std::invocable<lvalue_const_qualified, S const&>);
331 static_assert(!std::invocable<lvalue_const_qualified, S volatile&>);
332 static_assert(!std::invocable<lvalue_const_qualified, S const volatile&>);
333 static_assert(std::invocable<lvalue_const_qualified, S&&>);
334 static_assert(std::invocable<lvalue_const_qualified, S const&&>);
335 static_assert(!std::invocable<lvalue_const_qualified, S volatile&&>);
336 static_assert(!std::invocable<lvalue_const_qualified, S const volatile&&>);
337 
338 static_assert(check_member_is_invocable<int (S::*)() volatile&, S&>());
339 using lvalue_volatile_qualified = void (S::*)() volatile&;
340 static_assert(std::invocable<lvalue_volatile_qualified, S&>);
341 static_assert(!std::invocable<lvalue_volatile_qualified, S const&>);
342 static_assert(std::invocable<lvalue_volatile_qualified, S volatile&>);
343 static_assert(!std::invocable<lvalue_volatile_qualified, S const volatile&>);
344 static_assert(!std::invocable<lvalue_volatile_qualified, S&&>);
345 static_assert(!std::invocable<lvalue_volatile_qualified, S const&&>);
346 static_assert(!std::invocable<lvalue_volatile_qualified, S volatile&&>);
347 static_assert(!std::invocable<lvalue_volatile_qualified, S const volatile&&>);
348 
349 static_assert(check_member_is_invocable<int (S::*)() const volatile&, S&>());
350 using lvalue_cv_qualified = void (S::*)() const volatile&;
351 static_assert(std::invocable<lvalue_cv_qualified, S&>);
352 static_assert(std::invocable<lvalue_cv_qualified, S const&>);
353 static_assert(std::invocable<lvalue_cv_qualified, S volatile&>);
354 static_assert(std::invocable<lvalue_cv_qualified, S const volatile&>);
355 static_assert(!std::invocable<lvalue_cv_qualified, S&&>);
356 static_assert(!std::invocable<lvalue_cv_qualified, S const&&>);
357 static_assert(!std::invocable<lvalue_cv_qualified, S volatile&&>);
358 static_assert(!std::invocable<lvalue_cv_qualified, S const volatile&&>);
359 
360 using rvalue_unqualified = void (S::*)() &&;
361 static_assert(!std::invocable<rvalue_unqualified, S&>);
362 static_assert(!std::invocable<rvalue_unqualified, S const&>);
363 static_assert(!std::invocable<rvalue_unqualified, S volatile&>);
364 static_assert(!std::invocable<rvalue_unqualified, S const volatile&>);
365 static_assert(std::invocable<rvalue_unqualified, S&&>);
366 static_assert(!std::invocable<rvalue_unqualified, S const&&>);
367 static_assert(!std::invocable<rvalue_unqualified, S volatile&&>);
368 static_assert(!std::invocable<rvalue_unqualified, S const volatile&&>);
369 
370 using rvalue_const_unqualified = void (S::*)() const&&;
371 static_assert(!std::invocable<rvalue_const_unqualified, S&>);
372 static_assert(!std::invocable<rvalue_const_unqualified, S const&>);
373 static_assert(!std::invocable<rvalue_const_unqualified, S volatile&>);
374 static_assert(!std::invocable<rvalue_const_unqualified, S const volatile&>);
375 static_assert(std::invocable<rvalue_const_unqualified, S&&>);
376 static_assert(std::invocable<rvalue_const_unqualified, S const&&>);
377 static_assert(!std::invocable<rvalue_const_unqualified, S volatile&&>);
378 static_assert(!std::invocable<rvalue_const_unqualified, S const volatile&&>);
379 
380 using rvalue_volatile_unqualified = void (S::*)() volatile&&;
381 static_assert(!std::invocable<rvalue_volatile_unqualified, S&>);
382 static_assert(!std::invocable<rvalue_volatile_unqualified, S const&>);
383 static_assert(!std::invocable<rvalue_volatile_unqualified, S volatile&>);
384 static_assert(!std::invocable<rvalue_volatile_unqualified, S const volatile&>);
385 static_assert(std::invocable<rvalue_volatile_unqualified, S&&>);
386 static_assert(!std::invocable<rvalue_volatile_unqualified, S const&&>);
387 static_assert(std::invocable<rvalue_volatile_unqualified, S volatile&&>);
388 static_assert(!std::invocable<rvalue_volatile_unqualified, S const volatile&&>);
389 
390 using rvalue_cv_unqualified = void (S::*)() const volatile&&;
391 static_assert(!std::invocable<rvalue_cv_unqualified, S&>);
392 static_assert(!std::invocable<rvalue_cv_unqualified, S const&>);
393 static_assert(!std::invocable<rvalue_cv_unqualified, S volatile&>);
394 static_assert(!std::invocable<rvalue_cv_unqualified, S const volatile&>);
395 static_assert(std::invocable<rvalue_cv_unqualified, S&&>);
396 static_assert(std::invocable<rvalue_cv_unqualified, S const&&>);
397 static_assert(std::invocable<rvalue_cv_unqualified, S volatile&&>);
398 static_assert(std::invocable<rvalue_cv_unqualified, S const volatile&&>);
399 } // namespace pointer_to_member_functions
400 
401 // std::invocable-specific
402 static_assert(std::invocable<std::uniform_int_distribution<>, std::mt19937_64&>);
403 
404 // Check the concept with closure types
405 template<class F, class... Args>
406 constexpr bool is_invocable(F, Args&&...) {
407   return std::invocable<F, Args...>;
408 }
409 
410 static_assert(is_invocable([] {}));
411 static_assert(is_invocable([](int) {}, 0));
412 static_assert(is_invocable([](int) {}, 0L));
413 static_assert(!is_invocable([](int) {}, nullptr));
414 int i = 0;
415 static_assert(is_invocable([](int&) {}, i));
416