Task.hh

Go to the documentation of this file.

//
// MIT License
// Copyright (c) 2020 Jonathan R. Madsen
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
//
// ---------------------------------------------------------------
// Tasking class header file
//
// Class Description:
//
// This file defines the task types for TaskManager and ThreadPool
//
// ---------------------------------------------------------------
// Author: Jonathan Madsen (Feb 13th 2018)
// ---------------------------------------------------------------
 
#pragma once
 
#include "PTL/VTask.hh"
#include "PTL/detail/CxxBackports.hh"
 
#include <cstdint>
#include <future>
#include <tuple>
#include <utility>
 
namespace PTL
{
//======================================================================================//
 
/// \brief The task class is supplied to thread_pool.
template <typename RetT>
class TaskFuture : public VTask
{
public:
    using promise_type = std::promise<RetT>;
    using future_type  = std::future<RetT>;
    using result_type  = RetT;
 
public:
    // pass a free function pointer
    template <typename... Args>
    TaskFuture(Args&&... args)
    : VTask{ std::forward<Args>(args)... }
    {}
 
    ~TaskFuture() override = default;
 
    TaskFuture(const TaskFuture&) = delete;
    TaskFuture& operator=(const TaskFuture&) = delete;
 
    TaskFuture(TaskFuture&&) noexcept = default;
    TaskFuture& operator=(TaskFuture&&) noexcept = default;
 
public:
    // execution operator
    virtual future_type get_future() = 0;
    virtual void        wait()       = 0;
    virtual RetT        get()        = 0;
};
 
//======================================================================================//
 
/// \brief The task class is supplied to thread_pool.
template <typename RetT, typename... Args>
class PackagedTask : public TaskFuture<RetT>
{
public:
    using this_type          = PackagedTask<RetT, Args...>;
    using promise_type       = std::promise<RetT>;
    using future_type        = std::future<RetT>;
    using packaged_task_type = std::packaged_task<RetT(Args...)>;
    using result_type        = RetT;
    using tuple_type         = std::tuple<Args...>;
 
public:
    // pass a free function pointer
    template <typename FuncT>
    PackagedTask(FuncT func, Args... args)
    : TaskFuture<RetT>{ true, 0 }
    , m_ptask{ std::move(func) }
    , m_args{ args... }
    {}
 
    template <typename FuncT>
    PackagedTask(bool _is_native, intmax_t _depth, FuncT func, Args... args)
    : TaskFuture<RetT>{ _is_native, _depth }
    , m_ptask{ std::move(func) }
    , m_args{ args... }
    {}
 
    ~PackagedTask() override = default;
 
    PackagedTask(const PackagedTask&) = delete;
    PackagedTask& operator=(const PackagedTask&) = delete;
 
    PackagedTask(PackagedTask&&) noexcept = default;
    PackagedTask& operator=(PackagedTask&&) noexcept = default;
 
public:
    // execution operator
    void        operator()() final { PTL::apply(std::move(m_ptask), std::move(m_args)); }
    future_type get_future() final { return m_ptask.get_future(); }
    void        wait() final { return m_ptask.get_future().wait(); }
    RetT        get() final { return m_ptask.get_future().get(); }
 
private:
    packaged_task_type m_ptask;
    tuple_type         m_args;
};
 
//======================================================================================//
 
/// \brief The task class is supplied to thread_pool.
template <typename RetT, typename... Args>
class Task : public TaskFuture<RetT>
{
public:
    using this_type          = Task<RetT, Args...>;
    using promise_type       = std::promise<RetT>;
    using future_type        = std::future<RetT>;
    using packaged_task_type = std::packaged_task<RetT(Args...)>;
    using result_type        = RetT;
    using tuple_type         = std::tuple<Args...>;
 
public:
    template <typename FuncT>
    Task(FuncT func, Args... args)
    : TaskFuture<RetT>{}
    , m_ptask{ std::move(func) }
    , m_args{ args... }
    {}
 
    template <typename FuncT>
    Task(bool _is_native, intmax_t _depth, FuncT func, Args... args)
    : TaskFuture<RetT>{ _is_native, _depth }
    , m_ptask{ std::move(func) }
    , m_args{ args... }
    {}
 
    ~Task() override = default;
 
    Task(const Task&) = delete;
    Task& operator=(const Task&) = delete;
 
    Task(Task&&) noexcept = default;
    Task& operator=(Task&&) noexcept = default;
 
public:
    // execution operator
    void operator()() final
    {
        if(m_ptask.valid())
            PTL::apply(std::move(m_ptask), std::move(m_args));
    }
    future_type get_future() final { return m_ptask.get_future(); }
    void        wait() final { return m_ptask.get_future().wait(); }
    RetT        get() final { return m_ptask.get_future().get(); }
 
private:
    packaged_task_type m_ptask{};
    tuple_type         m_args{};
};
 
//======================================================================================//
 
/// \brief The task class is supplied to thread_pool.
template <typename RetT>
class Task<RetT, void> : public TaskFuture<RetT>
{
public:
    using this_type          = Task<RetT>;
    using promise_type       = std::promise<RetT>;
    using future_type        = std::future<RetT>;
    using packaged_task_type = std::packaged_task<RetT()>;
    using result_type        = RetT;
 
public:
    template <typename FuncT>
    Task(FuncT func)
    : TaskFuture<RetT>()
    , m_ptask{ std::move(func) }
    {}
 
    template <typename FuncT>
    Task(bool _is_native, intmax_t _depth, FuncT func)
    : TaskFuture<RetT>{ _is_native, _depth }
    , m_ptask{ std::move(func) }
    {}
 
    virtual ~Task() = default;
 
    Task(const Task&) = delete;
    Task& operator=(const Task&) = delete;
 
    Task(Task&&) noexcept = default;
    Task& operator=(Task&&) noexcept = default;
 
public:
    // execution operator
    virtual void        operator()() final { m_ptask(); }
    virtual future_type get_future() final { return m_ptask.get_future(); }
    virtual void        wait() final { return m_ptask.get_future().wait(); }
    virtual RetT        get() final { return m_ptask.get_future().get(); }
 
private:
    packaged_task_type m_ptask{};
};
 
//======================================================================================//
 
/// \brief The task class is supplied to thread_pool.
template <>
class Task<void, void> : public TaskFuture<void>
{
public:
    using RetT               = void;
    using this_type          = Task<void, void>;
    using promise_type       = std::promise<RetT>;
    using future_type        = std::future<RetT>;
    using packaged_task_type = std::packaged_task<RetT()>;
    using result_type        = RetT;
 
public:
    template <typename FuncT>
    explicit Task(FuncT func)
    : TaskFuture<RetT>{}
    , m_ptask{ std::move(func) }
    {}
 
    template <typename FuncT>
    Task(bool _is_native, intmax_t _depth, FuncT func)
    : TaskFuture<RetT>{ _is_native, _depth }
    , m_ptask{ std::move(func) }
    {}
 
    ~Task() override = default;
 
    Task(const Task&) = delete;
    Task& operator=(const Task&) = delete;
 
    Task(Task&&)  = default;
    Task& operator=(Task&&) = default;
 
public:
    // execution operator
    void        operator()() final { m_ptask(); }
    future_type get_future() final { return m_ptask.get_future(); }
    void        wait() final { return m_ptask.get_future().wait(); }
    RetT        get() final { return m_ptask.get_future().get(); }
 
private:
    packaged_task_type m_ptask{};
};
 
//======================================================================================//
 
}  // namespace PTL