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 线程被强制终止