os_tsk_delete

#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.
• Deleting a task frees all dynamic memory resources allocated to that task.

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) {
   ..
}