#include <rtl.h>

OS_RESULT os_tsk_delete (
    OS_TID task_id );    /* Id of the task to delete */

If a task has finished all its work or is not needed anymore, you can terminate it using the os_tsk_delete function. The os_tsk_delete function stops and deletes the task identified by task_id.

The os_tsk_delete function is in the RL-RTX library. The prototype is defined in rtl.h.

Note

• If task_id has a value of 0, the task that is currently running is stopped and deleted. The program execution continues with the task with the next highest priority in the ready queue.

The os_tsk_delete function returns OS_R_OK if the task was successfully stopped and deleted. In all other cases, for example if the task with task_id does not exist or is not running, the function returns OS_R_NOK.

os_tsk_delete_self

#include <rtl.h>
OS_TID tsk3;

__task void task2 (void) {
  tsk3 = os_tsk_create (task3, 0);
   ..
  if (os_tsk_delete (tsk3) == OS_R_OK) {
    printf("\n'task 3' deleted.");
  }
  else {
    printf ("\nFailed to delete 'task 3'.");
  }
}

__task void task3 (void) {
   ..
}