首页 > 编程笔记

pthread_cancel()函数:终止线程执行

线程结束执行的方式共有 3 种,分别是:
  1. 线程将指定函数体中的代码执行完后自行结束;
  2. 线程执行过程中,遇到 pthread_exit() 函数结束执行。
  3. 线程执行过程中,被同一进程中的其它线程(包括主线程)强制终止;

第一种方式很容易理解,第二种方式已经在《pthread_exit()函数》一节中做了详细的介绍,本节给大家介绍第 3 种方式。多线程程序中,一个线程可以借助 pthread_cancel() 函数向另一个线程发送“终止执行”的信号(后续称“Cancel”信号),从而令目标线程结束执行。

pthread_cancel() 函数声明在<pthread.h>头文件中,语法格式如下:
int pthread_cancel(pthread_t thread);
参数 thread 用于指定发送 Cancel 信号的目标线程。

如果 pthread_cancel() 函数成功地发送了 Cancel 信号,返回数字 0;反之如果发送失败,函数返回值为非零数。对于因“未找到目标线程”导致的信号发送失败,函数返回 ESRCH 宏(定义在<errno.h>头文件中,该宏的值为整数 3)。

注意,pthread_cancel() 函数的功能仅仅是向目标线程发送 Cancel 信号,至于目标线程是否处理该信号以及何时结束执行,由目标线程决定。我们会在《终止线程执行,这个坑千万别踩!》一节给您做详细讲解。

对于接收 Cancel 信号后结束执行的目标线程,等同于该线程自己执行如下语句:
pthread_exit(PTHREAD_CANCELED);
也就是说,当一个线程被强制终止执行时,它会返回 PTHREAD_CANCELED 这个宏(定义在<pthread.h>头文件中)。

接下来通过一个样例,给大家演示 pthread_cancel() 函数的用法:
#include <stdio.h>
#include <pthread.h>
#include <stdlib.h>     // sleep() 函数
//线程执行的函数
void * thread_Fun(void * arg) {
    printf("新建线程开始执行\n");
    sleep(10);
}

int main()
{
    pthread_t myThread;
    void * mess;
    int value;
    int res;
    //创建 myThread 线程
    res = pthread_create(&myThread, NULL, thread_Fun, NULL);
    if (res != 0) {
        printf("线程创建失败\n");
        return 0;
    }
    sleep(1);
    //向 myThread 线程发送 Cancel 信号
    res = pthread_cancel(myThread);
    if (res != 0) {
        printf("终止 myThread 线程失败\n");
        return 0;
    }
    //获取已终止线程的返回值
    res = pthread_join(myThread, &mess);
    if (res != 0) {
        printf("等待线程失败\n");
        return 0;
    }
    //如果线程被强制终止,其返回值为 PTHREAD_CANCELED
    if (mess == PTHREAD_CANCELED) {
        printf("myThread 线程被强制终止\n");
    }
    else {
        printf("error\n");
    }
    return 0;
}
假设程序编写在 thread.c 文件中,执行过程为:

[root@localhost ~]# gcc thread.c -o thread.exe -lpthread
[root@localhost ~]# ./thread.exe
新建线程开始执行
myThread 线程被强制终止

推荐阅读