TaskContext Class Reference

#include "TaskScheduler.h"

Public Member Functions
	TaskContext ()
	TaskContext (TaskScheduler::TaskContainer &&task, std::weak_ptr< TaskScheduler > &&owner)
	TaskContext (TaskContext const &right)
	TaskContext (TaskContext &&right)
TaskContext &	operator= (TaskContext const &right)
TaskContext &	operator= (TaskContext &&right)
bool	IsExpired () const
	Returns true if the owner was deallocated and this context has expired.
bool	IsInGroup (TaskScheduler::group_t const group) const
	Returns true if the event is in the given group.
TaskContext &	SetGroup (TaskScheduler::group_t const group)
	Sets the event in the given group.
TaskContext &	ClearGroup ()
	Removes the group from the event.
TaskScheduler::repeated_t	GetRepeatCounter () const
	Returns the repeat counter which increases every time the task is repeated.
template<class _Rep , class _Period >
TaskContext &	Repeat (std::chrono::duration< _Rep, _Period > const &duration)
TaskContext &	Repeat ()
template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >
TaskContext &	Repeat (std::chrono::duration< _RepLeft, _PeriodLeft > const &min, std::chrono::duration< _RepRight, _PeriodRight > const &max)
TaskContext &	Async (std::function< void()> const &callable)
template<class _Rep , class _Period >
TaskContext &	Schedule (std::chrono::duration< _Rep, _Period > const &time, TaskScheduler::task_handler_t const &task)
template<class _Rep , class _Period >
TaskContext &	Schedule (std::chrono::duration< _Rep, _Period > const &time, TaskScheduler::group_t const group, TaskScheduler::task_handler_t const &task)
template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >
TaskContext &	Schedule (std::chrono::duration< _RepLeft, _PeriodLeft > const &min, std::chrono::duration< _RepRight, _PeriodRight > const &max, TaskScheduler::task_handler_t const &task)
template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >
TaskContext &	Schedule (std::chrono::duration< _RepLeft, _PeriodLeft > const &min, std::chrono::duration< _RepRight, _PeriodRight > const &max, TaskScheduler::group_t const group, TaskScheduler::task_handler_t const &task)
TaskContext &	CancelAll ()
	Cancels all tasks from within the context.
TaskContext &	CancelGroup (TaskScheduler::group_t const group)
	Cancel all tasks of a single group from within the context.
TaskContext &	CancelGroupsOf (std::vector< TaskScheduler::group_t > const &groups)
template<class _Rep , class _Period >
TaskContext &	DelayAll (std::chrono::duration< _Rep, _Period > const &duration)
	Delays all tasks with the given duration from within the context.
template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >
TaskContext &	DelayAll (std::chrono::duration< _RepLeft, _PeriodLeft > const &min, std::chrono::duration< _RepRight, _PeriodRight > const &max)
	Delays all tasks with a random duration between min and max from within the context.
template<class _Rep , class _Period >
TaskContext &	DelayGroup (TaskScheduler::group_t const group, std::chrono::duration< _Rep, _Period > const &duration)
	Delays all tasks of a group with the given duration from within the context.
template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >
TaskContext &	DelayGroup (TaskScheduler::group_t const group, std::chrono::duration< _RepLeft, _PeriodLeft > const &min, std::chrono::duration< _RepRight, _PeriodRight > const &max)
	Delays all tasks of a group with a random duration between min and max from within the context.
template<class _Rep , class _Period >
TaskContext &	RescheduleAll (std::chrono::duration< _Rep, _Period > const &duration)
	Reschedule all tasks with the given duration.
template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >
TaskContext &	RescheduleAll (std::chrono::duration< _RepLeft, _PeriodLeft > const &min, std::chrono::duration< _RepRight, _PeriodRight > const &max)
	Reschedule all tasks with a random duration between min and max.
template<class _Rep , class _Period >
TaskContext &	RescheduleGroup (TaskScheduler::group_t const group, std::chrono::duration< _Rep, _Period > const &duration)
	Reschedule all tasks of a group with the given duration.
template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >
TaskContext &	RescheduleGroup (TaskScheduler::group_t const group, std::chrono::duration< _RepLeft, _PeriodLeft > const &min, std::chrono::duration< _RepRight, _PeriodRight > const &max)
	Reschedule all tasks of a group with a random duration between min and max.

Private Member Functions
TaskContext &	Dispatch (std::function< TaskScheduler &(TaskScheduler &)> const &apply)
	Dispatches an action safe on the TaskScheduler.
void	AssertOnConsumed () const
	Asserts if the task was consumed already.
void	Invoke ()
	Invokes the associated hook of the task.

Private Attributes
TaskScheduler::TaskContainer	_task
	Associated task.
std::weak_ptr< TaskScheduler >	_owner
	Owner.
std::shared_ptr< bool >	_consumed
	Marks the task as consumed.

Friends
class	TaskScheduler

Detailed Description

Constructor & Destructor Documentation

TaskContext() [1/4]

TaskContext::TaskContext ( )

inline

        : _task(), _owner(), _consumed(std::make_shared<bool>(true)) { }

TaskContext() [2/4]

TaskContext::TaskContext ( TaskScheduler::TaskContainer &&  task, std::weak_ptr< TaskScheduler > &&  owner  )

inlineexplicit

        : _task(task), _owner(owner), _consumed(std::make_shared<bool>(false)) { }

TaskContext() [3/4]

TaskContext::TaskContext ( TaskContext const &  right )

inline

        : _task(right._task), _owner(right._owner), _consumed(right._consumed) { }

TaskContext() [4/4]

TaskContext::TaskContext ( TaskContext &&  right )

inline

        : _task(std::move(right._task)), _owner(std::move(right._owner)), _consumed(std::move(right._consumed)) { }

Member Function Documentation

AssertOnConsumed()

void TaskContext::AssertOnConsumed ( ) const

private

Asserts if the task was consumed already.

{
    // This was adapted to TC to prevent static analysis tools from complaining.
    // If you encounter this assertion check if you repeat a TaskContext more then 1 time!
    ASSERT(!(*_consumed) && "Bad task logic, task context was consumed already!");
}

References ASSERT.

Referenced by Repeat().

Async()

TaskContext & TaskContext::Async

(

std::function< void()> const &

callable

)

Schedule a callable function that is executed at the next update tick from within the context. Its safe to modify the TaskScheduler from within the callable.

{
    return Dispatch(std::bind(&TaskScheduler::Async, std::placeholders::_1, callable));
}

References TaskScheduler::Async(), and TaskScheduler::Dispatch().

CancelAll()

TaskContext & TaskContext::CancelAll

(

)

Cancels all tasks from within the context.

{
    return Dispatch(std::mem_fn(&TaskScheduler::CancelAll));
}

References TaskScheduler::CancelAll(), and TaskScheduler::Dispatch().

CancelGroup()

TaskContext & TaskContext::CancelGroup

(

TaskScheduler::group_t const

group

)

Cancel all tasks of a single group from within the context.

{
    return Dispatch(std::bind(&TaskScheduler::CancelGroup, std::placeholders::_1, group));
}

References TaskScheduler::CancelGroup(), and TaskScheduler::Dispatch().

CancelGroupsOf()

TaskContext & TaskContext::CancelGroupsOf

(

std::vector< TaskScheduler::group_t > const &

groups

)

Cancels all groups in the given std::vector from within the context. Hint: Use std::initializer_list for this: "{1, 2, 3, 4}"

{
    return Dispatch(std::bind(&TaskScheduler::CancelGroupsOf, std::placeholders::_1, std::cref(groups)));
}

References TaskScheduler::CancelGroupsOf(), and TaskScheduler::Dispatch().

ClearGroup()

TaskContext & TaskContext::ClearGroup

(

)

Removes the group from the event.

{
    _task->_group = std::nullopt;
    return *this;
}

DelayAll() [1/2]

template<class _Rep , class _Period >

TaskContext & TaskContext::DelayAll ( std::chrono::duration< _Rep, _Period > const &  duration )

inline

Delays all tasks with the given duration from within the context.

    {
        return Dispatch(std::bind(&TaskScheduler::DelayAll<_Rep, _Period>, std::placeholders::_1, duration));
    }

References Dispatch().

Referenced by DelayAll().

DelayAll() [2/2]

template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >

TaskContext & TaskContext::DelayAll ( std::chrono::duration< _RepLeft, _PeriodLeft > const &  min, std::chrono::duration< _RepRight, _PeriodRight > const &  max  )

inline

Delays all tasks with a random duration between min and max from within the context.

    {
        return DelayAll(TaskScheduler::RandomDurationBetween(min, max));
    }

References DelayAll(), and TaskScheduler::RandomDurationBetween().

DelayGroup() [1/2]

template<class _Rep , class _Period >

TaskContext & TaskContext::DelayGroup ( TaskScheduler::group_t const  group, std::chrono::duration< _Rep, _Period > const &  duration  )

inline

Delays all tasks of a group with the given duration from within the context.

    {
        return Dispatch(std::bind(&TaskScheduler::DelayGroup<_Rep, _Period>, std::placeholders::_1, group, duration));
    }

References Dispatch().

Referenced by DelayGroup().

DelayGroup() [2/2]

template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >

TaskContext & TaskContext::DelayGroup ( TaskScheduler::group_t const  group, std::chrono::duration< _RepLeft, _PeriodLeft > const &  min, std::chrono::duration< _RepRight, _PeriodRight > const &  max  )

inline

Delays all tasks of a group with a random duration between min and max from within the context.

    {
        return DelayGroup(group, TaskScheduler::RandomDurationBetween(min, max));
    }

References DelayGroup(), and TaskScheduler::RandomDurationBetween().

Dispatch()

TaskContext & TaskContext::Dispatch ( std::function< TaskScheduler &(TaskScheduler &)> const &  apply )

private

Dispatches an action safe on the TaskScheduler.

{
    if (auto const owner = _owner.lock())
    {
        apply(*owner);
    }
 
    return *this;
}

Referenced by DelayAll(), DelayGroup(), Repeat(), RescheduleAll(), RescheduleGroup(), and Schedule().

GetRepeatCounter()

TaskScheduler::repeated_t TaskContext::GetRepeatCounter

(

)

const

Returns the repeat counter which increases every time the task is repeated.

{
    return _task->_repeated;
}

Referenced by boss_mor_grayhoof::DamageTaken(), npc_underbog_mushroom::InitializeAI(), npc_spawn_of_marli::JustEngagedWith(), and boss_eye_of_cthun::ScheduleTask().

Invoke()

void TaskContext::Invoke ( )

private

Invokes the associated hook of the task.

{
    _task->_task(*this);
}

Referenced by TaskScheduler::Dispatch().

IsExpired()

bool TaskContext::IsExpired

(

)

const

Returns true if the owner was deallocated and this context has expired.

{
    return _owner.expired();
}

IsInGroup()

bool TaskContext::IsInGroup

(

TaskScheduler::group_t const

group

)

const

Returns true if the event is in the given group.

{
    return _task->IsInGroup(group);
}

operator=() [1/2]

TaskContext & TaskContext::operator= ( TaskContext &&  right )

inline

    {
        _task = std::move(right._task);
        _owner = std::move(right._owner);
        _consumed = std::move(right._consumed);
        return *this;
    }

References _consumed, _owner, and _task.

operator=() [2/2]

TaskContext & TaskContext::operator= ( TaskContext const &  right )

inline

    {
        _task = right._task;
        _owner = right._owner;
        _consumed = right._consumed;
        return *this;
    }

References _consumed, _owner, and _task.

Repeat() [1/3]

TaskContext & TaskContext::Repeat ( )

inline

Repeats the event with the same duration. This will consume the task context, its not possible to repeat the task again from the same task context!

    {
        return Repeat(_task->_duration);
    }

References _task, and Repeat().

Referenced by Repeat().

Repeat() [2/3]

template<class _Rep , class _Period >

TaskContext & TaskContext::Repeat ( std::chrono::duration< _Rep, _Period > const &  duration )

inline

Repeats the event and sets a new duration. std::chrono::seconds(5) for example. This will consume the task context, its not possible to repeat the task again from the same task context!

    {
        AssertOnConsumed();
 
        // Set new duration, in-context timing and increment repeat counter
        _task->_duration = duration;
        _task->_end += duration;
        _task->_repeated += 1;
        (*_consumed) = true;
        return Dispatch(std::bind(&TaskScheduler::InsertTask, std::placeholders::_1, _task));
    }

References _task, AssertOnConsumed(), Dispatch(), and TaskScheduler::InsertTask().

Referenced by boss_thekal::boss_thekalAI::CheckPhaseTransition(), boss_mor_grayhoof::DamageTaken(), boss_isalien::DamageTaken(), boss_malchezaar::DamageTaken(), boss_ouro::DamageTaken(), boss_apothecary_hummel::boss_apothecary_hummelAI::DoAction(), boss_broggok::DoAction(), boss_ouro::Emerge(), boss_glob_of_viscidus::InitializeAI(), npc_underbog_mushroom::InitializeAI(), npc_corrupted_totem::IsSummonedBy(), boss_kormok::IsSummonedBy(), boss_attumen::boss_attumenAI::IsSummonedBy(), boss_mor_grayhoof::JustEngagedWith(), boss_malchezaar::JustEngagedWith(), npc_malchezaar_axe::JustEngagedWith(), boss_kormok::JustEngagedWith(), boss_baroness_anastari::boss_baroness_anastariAI::JustEngagedWith(), boss_jarien::JustEngagedWith(), boss_sothos::JustEngagedWith(), boss_twilight_corrupter::JustEngagedWith(), npc_batrider::JustEngagedWith(), npc_healing_ward::JustEngagedWith(), npc_shade_of_jindo::JustEngagedWith(), npc_vilebranch_speaker::JustEngagedWith(), boss_thekal::boss_thekalAI::JustEngagedWith(), npc_zealot_lorkhan::npc_zealot_lorkhanAI::JustEngagedWith(), npc_zealot_zath::npc_zealot_zathAI::JustEngagedWith(), npc_coren_direbrew_sisters::JustEngagedWith(), npc_hallows_end_soh::JustEngagedWith(), boss_azuregos::boss_azuregosAI::JustEngagedWith(), boss_aeonus::JustEngagedWith(), boss_chrono_lord_deja::JustEngagedWith(), boss_temporus::JustEngagedWith(), boss_isalien::JustEngagedWith(), npc_anubisath_guardian::JustEngagedWith(), npc_obsidian_destroyer::JustEngagedWith(), npc_claw_tentacle::JustEngagedWith(), npc_dirt_mound::JustEngagedWith(), npc_anubisath_defender::JustEngagedWith(), npc_obsidian_eradicator::JustEngagedWith(), npc_anubisath_warder::JustEngagedWith(), npc_obsidian_nullifier::JustEngagedWith(), npc_ahnqiraji_critter::JustEngagedWith(), boss_talon_king_ikiss::JustEngagedWith(), boss_dalliah_the_doomsayer::JustEngagedWith(), boss_zereketh_the_unbound::JustEngagedWith(), boss_commander_sarannis::JustEngagedWith(), boss_high_botanist_freywinn::JustEngagedWith(), boss_laj::JustEngagedWith(), boss_thorngrin_the_tender::JustEngagedWith(), boss_warp_splinter::JustEngagedWith(), npc_raliq_the_drunk::npc_raliq_the_drunkAI::JustEngagedWith(), npc_steamrigger_mechanic::JustEngagedWith(), boss_midnight::boss_midnightAI::JustEngagedWith(), npc_ohgan::npc_ohganAI::JustEngagedWith(), npc_hivezara_stinger::JustEngagedWith(), boss_kri::JustEngagedWith(), boss_vem::JustEngagedWith(), boss_yauj::JustEngagedWith(), boss_fankriss::JustEngagedWith(), boss_twinemperorsAI::JustEngagedWith(), boss_veknilash::JustEngagedWith(), boss_veklor::JustEngagedWith(), npc_vekniss_stinger::JustEngagedWith(), boss_hungarfen::JustEngagedWith(), boss_ayamiss::MovementInform(), npc_apothecary_baxter::Reset(), npc_shade_of_jindo::Reset(), npc_eye_tentacle::Reset(), npc_giant_eye_tentacle::Reset(), npc_ahnqiraji_critter::Reset(), npc_raliq_the_drunk::npc_raliq_the_drunkAI::Reset(), npc_dream_fog::npc_dream_fogAI::ScheduleEvents(), boss_baroness_anastari::boss_baroness_anastariAI::SchedulePossession(), boss_commander_sarannis::ScheduleReinforcements(), boss_eye_of_cthun::ScheduleTask(), npc_giant_claw_tentacle::ScheduleTasks(), boss_attumen::boss_attumenAI::ScheduleTasks(), boss_ayamiss::ScheduleTasks(), boss_cthun::ScheduleTasks(), and instance_ruins_of_ahnqiraj::instance_ruins_of_ahnqiraj_InstanceMapScript::SetData().

Repeat() [3/3]

template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >

TaskContext & TaskContext::Repeat ( std::chrono::duration< _RepLeft, _PeriodLeft > const &  min, std::chrono::duration< _RepRight, _PeriodRight > const &  max  )

inline

Repeats the event and set a new duration that is randomized between min and max. std::chrono::seconds(5) for example. This will consume the task context, its not possible to repeat the task again from the same task context!

    {
        return Repeat(TaskScheduler::RandomDurationBetween(min, max));
    }

References TaskScheduler::RandomDurationBetween(), and Repeat().

RescheduleAll() [1/2]

template<class _Rep , class _Period >

TaskContext & TaskContext::RescheduleAll ( std::chrono::duration< _Rep, _Period > const &  duration )

inline

Reschedule all tasks with the given duration.

    {
        return Dispatch(std::bind(&TaskScheduler::RescheduleAll, std::placeholders::_1, duration));
    }

References Dispatch(), and TaskScheduler::RescheduleAll().

Referenced by RescheduleAll().

RescheduleAll() [2/2]

template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >

TaskContext & TaskContext::RescheduleAll ( std::chrono::duration< _RepLeft, _PeriodLeft > const &  min, std::chrono::duration< _RepRight, _PeriodRight > const &  max  )

inline

Reschedule all tasks with a random duration between min and max.

    {
        return RescheduleAll(TaskScheduler::RandomDurationBetween(min, max));
    }

References TaskScheduler::RandomDurationBetween(), and RescheduleAll().

RescheduleGroup() [1/2]

template<class _Rep , class _Period >

TaskContext & TaskContext::RescheduleGroup ( TaskScheduler::group_t const  group, std::chrono::duration< _Rep, _Period > const &  duration  )

inline

Reschedule all tasks of a group with the given duration.

    {
        return Dispatch(std::bind(&TaskScheduler::RescheduleGroup<_Rep, _Period>, std::placeholders::_1, group, duration));
    }

References Dispatch().

Referenced by RescheduleGroup().

RescheduleGroup() [2/2]

template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >

TaskContext & TaskContext::RescheduleGroup ( TaskScheduler::group_t const  group, std::chrono::duration< _RepLeft, _PeriodLeft > const &  min, std::chrono::duration< _RepRight, _PeriodRight > const &  max  )

inline

Reschedule all tasks of a group with a random duration between min and max.

    {
        return RescheduleGroup(group, TaskScheduler::RandomDurationBetween(min, max));
    }

References TaskScheduler::RandomDurationBetween(), and RescheduleGroup().

Schedule() [1/4]

template<class _Rep , class _Period >

TaskContext & TaskContext::Schedule ( std::chrono::duration< _Rep, _Period > const &  time, TaskScheduler::group_t const  group, TaskScheduler::task_handler_t const &  task  )

inline

Schedule an event with a fixed rate from within the context. Its possible that the new event is executed immediately! Use TaskScheduler::Async to create a task which will be called at the next update tick.

    {
        auto const end = _task->_end;
        return Dispatch([end, time, group, task](TaskScheduler & scheduler) -> TaskScheduler &
        {
            return scheduler.ScheduleAt<_Rep, _Period>(end, time, group, task);
        });
    }

References _task, Dispatch(), and TaskScheduler::ScheduleAt().

Schedule() [2/4]

template<class _Rep , class _Period >

TaskContext & TaskContext::Schedule ( std::chrono::duration< _Rep, _Period > const &  time, TaskScheduler::task_handler_t const &  task  )

inline

Schedule an event with a fixed rate from within the context. Its possible that the new event is executed immediately! Use TaskScheduler::Async to create a task which will be called at the next update tick.

    {
        auto const end = _task->_end;
        return Dispatch([end, time, task](TaskScheduler & scheduler) -> TaskScheduler &
        {
            return scheduler.ScheduleAt<_Rep, _Period>(end, time, task);
        });
    }

References _task, Dispatch(), and TaskScheduler::ScheduleAt().

Referenced by boss_isalien::DamageTaken(), boss_apothecary_hummel::boss_apothecary_hummelAI::DoAction(), boss_glob_of_viscidus::InitializeAI(), npc_underbog_mushroom::InitializeAI(), and Schedule().

Schedule() [3/4]

template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >

TaskContext & TaskContext::Schedule ( std::chrono::duration< _RepLeft, _PeriodLeft > const &  min, std::chrono::duration< _RepRight, _PeriodRight > const &  max, TaskScheduler::group_t const  group, TaskScheduler::task_handler_t const &  task  )

inline

Schedule an event with a randomized rate between min and max rate from within the context. Its possible that the new event is executed immediately! Use TaskScheduler::Async to create a task which will be called at the next update tick.

    {
        return Schedule(TaskScheduler::RandomDurationBetween(min, max), group, task);
    }

References TaskScheduler::RandomDurationBetween(), and Schedule().

Schedule() [4/4]

template<class _RepLeft , class _PeriodLeft , class _RepRight , class _PeriodRight >

TaskContext & TaskContext::Schedule ( std::chrono::duration< _RepLeft, _PeriodLeft > const &  min, std::chrono::duration< _RepRight, _PeriodRight > const &  max, TaskScheduler::task_handler_t const &  task  )

inline

Schedule an event with a randomized rate between min and max rate from within the context. Its possible that the new event is executed immediately! Use TaskScheduler::Async to create a task which will be called at the next update tick.

    {
        return Schedule(TaskScheduler::RandomDurationBetween(min, max), task);
    }

References TaskScheduler::RandomDurationBetween(), and Schedule().

SetGroup()

TaskContext & TaskContext::SetGroup

(

TaskScheduler::group_t const

group

)

Sets the event in the given group.

{
    _task->_group = group;
    return *this;
}

Referenced by boss_malchezaar::DamageTaken(), boss_malchezaar::JustEngagedWith(), instance_the_black_morass::instance_the_black_morass_InstanceMapScript::ScheduleNextPortal(), boss_eye_of_cthun::ScheduleTask(), boss_ayamiss::ScheduleTasks(), and instance_ruins_of_ahnqiraj::instance_ruins_of_ahnqiraj_InstanceMapScript::SetData().

Friends And Related Function Documentation

TaskScheduler

friend class TaskScheduler

friend

Member Data Documentation

_consumed

std::shared_ptr<bool> TaskContext::_consumed

private

Marks the task as consumed.

Referenced by operator=().

_owner

std::weak_ptr<TaskScheduler> TaskContext::_owner

private

Owner.

Referenced by operator=().

_task

TaskScheduler::TaskContainer TaskContext::_task

private

Associated task.

Referenced by operator=(), Repeat(), and Schedule().