##### Synopsis

    #include <ctl_api.h>
    void ctl_task_remove(CTL_TASK_t *task);

##### Description

ctl_task_remove removes the task task from the waiting task list. Once you you have removed a task the only way to re-introduce it to the system is to call ctl_task_run.

You can remove the currently executing task by passing ctl_task_executing to ctl_task_remove which is the same as calling ctl_task_die. You cannot remove the currently executing task from an interrupt service routine; if you do, the error handler is called with the reason code CTL_SUICIDE_IN_ISR.

##### Portability

ctl_task_remove is provided in every implementation of the CrossWorks tasking library.