/* * Copyright 2020 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #pragma once #include #include #include namespace android::ftl { // Creates a future that defers a function call until its result is queried. // // auto future = ftl::defer([](int x) { return x + 1; }, 99); // assert(future.get() == 100); // template inline auto defer(F&& f, Args&&... args) { return std::async(std::launch::deferred, std::forward(f), std::forward(args)...); } // Creates a future that wraps a value. // // auto future = ftl::yield(42); // assert(future.get() == 42); // // auto ptr = std::make_unique('!'); // auto future = ftl::yield(std::move(ptr)); // assert(*future.get() == '!'); // template inline std::future yield(T&& v) { return defer([](T&& v) { return std::forward(v); }, std::forward(v)); } namespace details { template struct future_result { using type = T; }; template struct future_result> { using type = T; }; template using future_result_t = typename future_result::type; // Attaches a continuation to a future. The continuation is a function that maps T to either R or // std::future. In the former case, the chain wraps the result in a future as if by ftl::yield. // // auto future = ftl::yield(123); // std::future futures[] = {ftl::yield('a'), ftl::yield('b')}; // // std::future chain = // ftl::chain(std::move(future)) // .then([](int x) { return static_cast(x % 2); }) // .then([&futures](std::size_t i) { return std::move(futures[i]); }); // // assert(chain.get() == 'b'); // template struct Chain { // Implicit conversion. Chain(std::future&& f) : future(std::move(f)) {} operator std::future&&() && { return std::move(future); } T get() && { return future.get(); } template > auto then(F&& op) && -> Chain> { return defer( [](auto&& f, F&& op) { R r = op(f.get()); if constexpr (std::is_same_v>) { return r; } else { return r.get(); } }, std::move(future), std::forward(op)); } std::future future; }; } // namespace details template inline auto chain(std::future&& f) -> details::Chain { return std::move(f); } } // namespace android::ftl