mgl_task.h

[詳解]

// SPDX-License-Identifier: Zlib
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
 
#ifndef INCGUARD_MGL_TASK_H_1622688410
#define INCGUARD_MGL_TASK_H_1622688410
 
#include <mgl/mgl_environment.h>
#include <mgl/task/mgl_task_default_task_node.h>
#include <mgl/task/mgl_task_node_list.h>
#include <mgl/task/mgl_task_weak_node.h>
 
namespace MGL::Task
{
bool Initialize(size_t capacity, const InitializeDescriptor &descriptor) noexcept;
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
template <class TaskClass, class... Args>
constexpr WeakNode Create(Args... args) noexcept
{
    auto &nodeList = NodeList::GetInstance();
    if (!nodeList.HasFreeNode())
    {
        return {};
    }
 
    auto index = nodeList.Add(STL::make_unique<TaskClass>(args...));
 
    return WeakNode(index);
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
inline void Execute() noexcept
{
    NodeList::GetInstance().Execute();
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
inline size_t Kill(ResideLevel resideLevel = ResideLevel::NoResident) noexcept
{
    return NodeList::GetInstance().Kill(resideLevel);
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
template <typename TaskIDType>
inline size_t Kill(TaskIDType identifier, ResideLevel resideLevel = ResideLevel::NoResident) noexcept
{
    return NodeList::GetInstance().Kill(Identifier(identifier), resideLevel);
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
inline size_t DestroyThemAll() noexcept
{
    return Kill(ResideLevel::Max);
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
inline size_t GetCount() noexcept
{
    return NodeList::GetInstance().GetCount();
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
template <typename TaskIDType>
inline size_t GetCount(TaskIDType identifier) noexcept
{
    return NodeList::GetInstance().GetCount(identifier);
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
template <typename TaskIDType>
STL::vector<WeakNode> Find(TaskIDType identifier) noexcept
{
    STL::vector<WeakNode> result;
 
    NodeList::GetInstance().GetNodeArray(result, Identifier(identifier));
 
    return result;
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
template <typename EventIDType>
inline void NotifyEvent(EventIDType eventID, void *argument = nullptr) noexcept
{
    NodeList::GetInstance().NotifyEvent(EventIdentifier(eventID), argument);
}
 
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
template <typename TaskIDType, typename EventIDType>
inline void NotifyEvent(TaskIDType identifier, EventIDType eventID, void *argument = nullptr) noexcept
{
    NodeList::GetInstance().NotifyEvent(Identifier(identifier), EventIdentifier(eventID), argument);
}
 
}    // namespace MGL::Task
 
#endif    // INCGUARD_MGL_TASK_H_1622688410
 
// vim: et ts=4 sw=4 sts=4