线程删除

对于一些使用rt_thread_create创建出来的线程，当不需要使用，或者运行出错时，我们可以使用下面的函数接口来从系统中把线程完全删除掉：

  1. rt_err_t rt_thread_delete(rt_thread_t thread);

调用该函数后，线程对象将会被移出线程队列并且从内核对象管理器中删除，线程占用的堆栈空间也会被释放，收回的空间将重新用于其他的内存分配。实际上，用rt_thread_delete函数删除线程接口，仅仅是把相应的线程状态更改为RT_THREAD_CLOSE状态，然后放入到rt_thread_defunct队列中；而真正的删除动作（释放线程控制块和释放线程栈）需要到下一次执行idle线程时，由idle线程完成最后的线程删除动作。用rt_thread_init初始化的静态线程则不能使用此接口删除。

线程安全

安全

中断例程

可调用

函数参数

  1.       参数  描述
  1.     thread  要删除的线程句柄；

函数返回

返回RT_EOK

  • 注：在线程运行完成，自动结束的情况下，系统会自动删除线程，不需要再调用rt_thread_delete()函数接口。这个接口不应由线程本身来调用以删除线程自身，一般只能由其他线程调用或在定时器超时函数中调用。
    这个函数仅在使能了系统动态堆时才有效（即RT_USING_HEAP宏定义已经定义了）。

下面举一个删除线程的例子，如下代码：

  1. /*
  2.  * 程序清单：删除线程
  3.  *
  4.  * 这个例子会创建两个线程，在一个线程中删除另外一个线程。
  5.  */
  6. #include <rtthread.h>
  7.  
  8. #define THREAD_PRIORITY         25
  9. #define THREAD_STACK_SIZE       512
  10. #define THREAD_TIMESLICE        5
  11.  
  12. /*
  13.  * 线程删除(rt_thread_delete)函数仅适合于动态线程，为了在一个线程
  14.  * 中访问另一个线程的控制块，所以把线程块指针声明成全局类型以供全
  15.  * 局访问
  16.  */
  17. static rt_thread_t tid1 = RT_NULL, tid2 = RT_NULL;
  18.  
  19. /* 线程1的入口函数 */
  20. static void thread1_entry(void* parameter)
  21. {
  22.     rt_uint32_t count = 0;
  23.  
  24.     while (1)
  25.     {
  26.         /* 线程1采用低优先级运行，一直打印计数值 */
  27.         rt_kprintf("thread count: %d\n", count ++);
  28.     }
  29. }
  30.  
  31. /* 线程2的入口函数 */
  32. static void thread2_entry(void* parameter)
  33. {
  34.     /* 线程2拥有较高的优先级，以抢占线程1而获得执行 */
  35.  
  36.     /* 线程2启动后先睡眠10个OS Tick */
  37.     rt_thread_delay(10);
  38.  
  39.     /*
  40.      * 线程2唤醒后直接删除线程1，删除线程1后，线程1自动脱离就绪线程
  41.      * 队列
  42.      */
  43.     rt_thread_delete(tid1);
  44.     tid1 = RT_NULL;
  45.  
  46.     /*
  47.      * 线程2继续休眠10个OS Tick然后退出，线程2休眠后应切换到idle线程
  48.      * idle线程将执行真正的线程1控制块和线程栈的删除
  49.      */
  50.     rt_thread_delay(10);
  51.  
  52.     /*
  53.      * 线程2运行结束后也将自动被删除(线程控制块和线程栈依然在idle线
  54.      * 程中释放)
  55.      */
  56.     tid2 = RT_NULL;
  57. }
  58.  
  59. /* 应用入口 */
  60. int rt_application_init()
  61. {
  62.     /* 创建线程1 */
  63.     tid1 = rt_thread_create("t1", /* 线程1的名称是t1 */
  64.         thread1_entry, RT_NULL,   /* 入口是thread1_entry，参数是RT_NULL */
  65.         THREAD_STACK_SIZE, THREAD_PRIORITY, THREAD_TIMESLICE);
  66.     if (tid1 != RT_NULL) /* 如果获得线程控制块，启动这个线程 */
  67.         rt_thread_startup(tid1);
  68.     else
  69.         return -1;
  70.  
  71.     /* 创建线程1 */
  72.     tid2 = rt_thread_create("t2", /* 线程1的名称是t2 */
  73.         thread2_entry, RT_NULL,   /* 入口是thread2_entry，参数是RT_NULL */
  74.         THREAD_STACK_SIZE, THREAD_PRIORITY - 1, THREAD_TIMESLICE);
  75.     if (tid2 != RT_NULL) /* 如果获得线程控制块，启动这个线程 */
  76.         rt_thread_startup(tid2);
  77.     else
  78.         return -1;
  79.  
  80.     return 0;
  81. }