====== OSA : OS_Task_Delete ======
<color blue>**OS_Task_Delete (OST_TASK_POINTER tp)**</color>\\ 
=== ===

Stop task and delete it from the list of active tasks. Be careful using this service and do not forget to free all task resources before stopping the task. It is recommended that you clear the pointer to the task descriptor after stopping the task.


<note>
Before calling this service you should be sure that variable //tp// was initialized.
</note>

The macro **this_task** or the service ##[[en:osa:ref:allservices:OS_Task_GetCur|OS_Task_GetCur]]##() can be used to perform this operation on the current task. When a task stops itself, the kernel gets control immediately.



=== Call allowed: ===
Only in task


=== Parameters: ===
{| class = "fpl"
|-
|//''to''//
|Pointer to task descriptor (##[[en:osa:ref:description:data_types#OST_TASK_POINTER|OST_TASK_POINTER]]##*)
|}


=== Returns: ===
nothing

=== Example: ===
<code cpp>
void Task (void)
{
    for (;;) {
        /*...*/
        // Free all resources
        /*...*/
        // And stop current task
        OS_Task_Delete(this_task);
        /*...*/
    }
}
</code>


=== Old style name ===
<color gray>**OS_DeleteTask**</color>\\ 








=== See also ===
  * [[en:osa:ref:allservices:OS_Task_Create|OS_Task_Create]]
  * [[en:osa:ref:allservices:OS_Task_Replace|OS_Task_Replace]]
  * [[en:osa:ref:allservices:OS_Task_Delete|OS_Task_Delete]]
  * [[en:osa:ref:allservices:OS_Task_Define|OS_Task_Define]]

  * [[en:osa:ref:allservices:OS_Task_GetCur|OS_Task_GetCur]]
  * [[en:osa:ref:allservices:OS_Task_GetCreated|OS_Task_GetCreated]]
  * [[en:osa:ref:allservices:OS_Task_Pause|OS_Task_Pause]]
  * [[en:osa:ref:allservices:OS_Task_Continue|OS_Task_Continue]]
  * [[en:osa:ref:allservices:OS_Task_IsPaused|OS_Task_IsPaused]]

  * [[en:osa:ref:allservices:OS_Task_GetPriority|OS_Task_GetPriority]]
  * [[en:osa:ref:allservices:OS_Task_SetPriority|OS_Task_SetPriority]]

----
  * [[en:osa:ref:services:alphabetical|Alphabetical]]
  * [[en:osa:ref:services:brieflist|All services]]
~~UP~~