A work in its infancy. Suggested and contributed to by Peter Featherstone.
Contents
- Example usage
- In a nutshell
- License
- Dependencies
- Installation
- Synopsis
- Other implementations of invoke
- Notes and references
- Appendix
#include "nonstd/invoke.hpp"
#include <array>
#include <utility>
int add(int first, int second)
{
return first + second;
}
int main()
{
return
+ nonstd::invoke(add, 1, 2)
+ nonstd::apply(add, std::pair <int, int>(1, 2))
+ nonstd::apply(add, std::tuple<int, int>(1, 2))
+ nonstd::apply(add, std::array<int, 2>({1, 2}));
}g++ -std=c++11 -Wall -I../include -o 00-basic.exe 00-basic.cpp && ./00-basic.exe || echo $?
12
invoke lite is a single-file header-only library to provide C++17's invoke for use with C++98 and later and C++17's apply for use with C++11 and later. If available, the standard library is used, unless configured otherwise.
Currently nonstd::invoke ... .
Currently nonstd::apply ... .
Features and properties of invoke lite are ease of installation (single header), freedom of dependencies other than the standard library.
Limitations of invoke lite are ... [to be summed up].
invoke lite is distributed under the Boost Software License.
invoke lite has no other dependencies than the C++ standard library.
invoke lite is a single-file header-only library. Put invoke.hpp in the include folder directly into the project source tree or somewhere reachable from your project.
[Envisioned] Depending on the compiler and C++ standard used, invoke lite behaves less or more like the standard's version. To get an idea of the capabilities of invoke lite with your configuration, look at the output of the tests, issuing invoke-main.t --pass @.
For the standard's documentation, see invoke, which is part of the C++ utility function objects library and apply, which is part of the C++ utility library.
| Kind | C++ | Type or function | Notes |
|---|---|---|---|
| C++11 |
template< class F, class Tuple > constexpr decltype(auto) apply(F&& f, Tuple&& t) |
||
| C++98 | invoke() | ||
| C++98 | invoke() | ||
If the compiler supports __has_include(), invoke lite supports the tweak header mechanism. Provide your tweak header as nonstd/invoke.tweak.hpp in a folder in the include-search-path. In the tweak header, provide definitions as documented below, like #define invoke_CPLUSPLUS 201103L.
At default, invoke lite uses std::invoke if it is available and lets you use it via namespace nonstd. You can however override this default and explicitly request to use std::invoke or invoke lite's nonstd::invoke as nonstd::invoke via the following macros.
-Dinvoke_CONFIG_SELECT_INVOKE=invoke_INVOKE_NONSTD
Define this to invoke_INVOKE_STD to select std::invoke as nonstd::invoke. Define this to invoke_INVOKE_NONSTD to select nonstd::invoke as nonstd::invoke. Default is undefined, which has the same effect as defining to invoke_INVOKE_DEFAULT.
-Dinvoke_CPLUSPLUS=199711L
Define this macro to override the auto-detection of the supported C++ standard, if your compiler does not set the __cplusplus macro correctly.
-Dinvoke_CONFIG_NO_EXCEPTIONS=0
Define this to 1 if you want to compile without exceptions. If not defined, the header tries and detect if exceptions have been disabled (e.g. via -fno-exceptions). Default is undefined.
- TBD.
- TBD
- p1065 - constexpr INVOKE.
- n4169 - A proposal to add invoke function template. Tomasz Kamiński. 2014
The version of invoke lite is available via tag [.version]. The following tags are available for information on the compiler and on the C++ standard library used: [.compiler], [.stdc++], [.stdlanguage] and [.stdlibrary].
click to expand
invoke: a free function, no arguments
invoke: a free function, no arguments, noexcept(false) (C++11)
invoke: a free function, 1 argument
invoke: a free function, 2 arguments
invoke: a member function, no arguments
invoke: a member function, 1 argument
invoke: a member function, 1 const ref argument
invoke: a non-const member function, 1 argument
invoke: a member function, changing its reference argument
invoke: (access) a data member - via const object ref
invoke: (access) a data member - via const object ptr
invoke: (access) a data member - via non-const object ref
invoke: (access) a data member - via non-const object ptr
invoke: change an invoked (accessed) data member - via non-const object ref
invoke: change an invoked (accessed) data member - via non-const object ptr
invoke: a function object, no arguments
invoke: a function object, 1 argument
invoke: a lambda, no arguments
invoke: a lambda, 1 argument
invoke: a free function, no arguments - constexpr
invoke: a free function, no arguments, noexcept(false) (C++11) - constexpr
invoke: a free function, 1 argument - constexpr
invoke: a free function, 2 arguments - constexpr
invoke: a member function, no arguments - constexpr
invoke: a member function, 1 argument - constexpr
invoke: a member function, 1 const ref argument - constexpr
invoke: (access) a data member - via const object ref - constexpr
invoke: (access) a data member - via const object ptr - constexpr
invoke: a function object, no arguments - constexpr
invoke: a function object, 1 argument - constexpr
invoke: a lambda, no arguments - constexpr (C++17)
invoke: a lambda, 1 argument - constexpr (C++17)
apply: a function object, std::pair of 2 arguments (C++11)
apply: a function object, std::tuple of 2 arguments (C++11)
apply: a function object, std::array of 2 arguments (C++11)
apply: a lambda, std::pair of 2 arguments (C++11)
apply: a lambda, std::tuple of 2 arguments (C++11)
apply: a lambda, std::array of 2 arguments (C++11)
apply: a function object, std::pair of 2 arguments (C++11) - constexpr
apply: a function object, std::tuple of 2 arguments (C++11) - constexpr
apply: a function object, std::array of 2 arguments (C++11) - constexpr
apply: a lambda, std::pair of 2 arguments (C++11) - constexpr
apply: a lambda, std::tuple of 2 arguments (C++11) - constexpr
apply: a lambda, std::array of 2 arguments (C++11) - constexpr
tweak header: Reads tweak header if supported [tweak]