线程删除
对于一些使用rt_thread_create创建出来的线程,当不需要使用,或者运行出错时,我们可以使用下面的函数接口来从系统中把线程完全删除掉:
rt_err_t rt_thread_delete(rt_thread_t thread);
调用该函数后,线程对象将会被移出线程队列并且从内核对象管理器中删除,线程占用的堆栈空间也会被释放,收回的空间将重新用于其他的内存分配。实际上,用rt_thread_delete函数删除线程接口,仅仅是把相应的线程状态更改为RT_THREAD_CLOSE状态,然后放入到rt_thread_defunct队列中;而真正的删除动作(释放线程控制块和释放线程栈)需要到下一次执行idle线程时,由idle线程完成最后的线程删除动作。用rt_thread_init初始化的静态线程则不能使用此接口删除。
线程安全
安全
中断例程
可调用
函数参数
参数 描述
thread 要删除的线程句柄;
函数返回
返回RT_EOK
注:在线程运行完成,自动结束的情况下,系统会自动删除线程,不需要再调用rt_thread_delete()函数接口。这个接口不应由线程本身来调用以删除线程自身,一般只能由其他线程调用或在定时器超时函数中调用。
这个函数仅在使能了系统动态堆时才有效(即RT_USING_HEAP宏定义已经定义了)。
下面举一个删除线程的例子,如下代码:
/*
程序清单:删除线程
这个例子会创建两个线程,在一个线程中删除另外一个线程。
*/
#include <rtthread.h>
#define THREAD_PRIORITY 25
#define THREAD_STACK_SIZE 512
#define THREAD_TIMESLICE 5
/*
线程删除(rt_thread_delete)函数仅适合于动态线程,为了在一个线程
中访问另一个线程的控制块,所以把线程块指针声明成全局类型以供全
- 局访问
*/
static rt_thread_t tid1 = RT_NULL, tid2 = RT_NULL;
/* 线程1的入口函数 */
static void thread1_entry(void* parameter)
{
rt_uint32_t count = 0;
while (1)
{
/* 线程1采用低优先级运行,一直打印计数值 */
rt_kprintf("thread count: %d\n", count ++);
}
}
static void thread2_entry(void* parameter)
{
/* 线程2拥有较高的优先级,以抢占线程1而获得执行 */
/* 线程2启动后先睡眠10个OS Tick */
rt_thread_delay(10);
/*
- 线程2唤醒后直接删除线程1,删除线程1后,线程1自动脱离就绪线程
- 队列
*/
rt_thread_delete(tid1);
tid1 = RT_NULL;
/*
- 线程2继续休眠10个OS Tick然后退出,线程2休眠后应切换到idle线程
- idle线程将执行真正的线程1控制块和线程栈的删除
*/
rt_thread_delay(10);
/*
- 线程2运行结束后也将自动被删除(线程控制块和线程栈依然在idle线
- 程中释放)
*/
tid2 = RT_NULL;
}
int rt_application_init()
{
/* 创建线程1 /
tid1 = rt_thread_create("t1", / 线程1的名称是t1 /
thread1_entry, RT_NULL, / 入口是thread1_entry,参数是RT_NULL /
THREAD_STACK_SIZE, THREAD_PRIORITY, THREAD_TIMESLICE);
if (tid1 != RT_NULL) / 如果获得线程控制块,启动这个线程 */
rt_thread_startup(tid1);
else
return -1;
/* 创建线程1 /
tid2 = rt_thread_create("t2", / 线程1的名称是t2 /
thread2_entry, RT_NULL, / 入口是thread2_entry,参数是RT_NULL /
THREAD_STACK_SIZE, THREAD_PRIORITY - 1, THREAD_TIMESLICE);
if (tid2 != RT_NULL) / 如果获得线程控制块,启动这个线程 */
rt_thread_startup(tid2);
else
return -1;
return 0;
}
原作者:文江博客