##### Synopsis

    #include <ctl_api.h>
    void ctl_task_die(void);

##### Description

ctl_task_die terminates the currently executing task and schedules the next ready task. 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_die is provided in every implementation of the CrossWorks tasking library.