【多线程编程学习笔记5】获取线程函数的返回值:pthread_join() 函数

申明：本学习笔记是在该教程的基础上结合自己的学习情况进行的总结，不是原创，想要看原版的请看C语言中文网的多线程编程（C语言+Linux），该网站有很多好的编程学习教程，尤其是关于C语言的。

前面提到，如果我们想获取某个线程执行结束时返回的数据，可以调用 pthread_join() 函数来实现。本节，我们就为您详细讲解 pthread_join() 函数的功能和用法。

pthread_join() 函数声明在头文件中，语法格式如下：

int pthread_join(pthread_t thread, void ** retval);

thread 参数用于指定接收哪个线程的返回值；retval 参数表示接收到的返回值，如果 thread 线程没有返回值，又或者我们不需要接收 thread 线程的返回值，可以将 retval 参数置为 NULL。

pthread_join() 函数会一直阻塞调用它的线程，直至目标线程执行结束（接收到目标线程的返回值），阻塞状态才会解除。(如果是主线程调用pthread_join(),那么会阻塞主线程，等目标线程执行结束，主线程的阻塞状态才会解除)

如果 pthread_join() 函数成功等到了目标线程执行结束（成功获取到目标线程的返回值），返回值为数字 0；反之如果执行失败，函数会根据失败原因返回相应的非零值，每个非零值都对应着不同的宏，例如：

• EDEADLK：检测到线程发生了死锁。关于线程发生死锁，我们会在《Linux如何避免线程发生死锁？》一节中做详细讲解。
• EINVAL：分为两种情况，要么目标线程本身不允许其它线程获取它的返回值，要么事先就已经有线程调用 pthread_join() 函数获取到了目标线程的返回值。
• ESRCH：找不到指定的 thread 线程。

以上这些宏都声明在 头文件中，如果程序中想使用这些宏，需提前引入此头文件。

再次强调，一个线程执行结束的返回值只能由一个 pthread_join() 函数获取，当有多个线程调用 pthread_join() 函数获取同一个线程的执行结果时，哪个线程最先执行 pthread_join() 函数，执行结果就由那个线程获得，其它线程的 pthread_join() 函数都将执行失败。

对于一个默认属性的线程 A 来说，线程占用的资源并不会因为执行结束而得到释放。而通过在其它线程中执行pthread_join(A,NULL);语句，可以轻松实现“及时释放线程 A 所占资源”的目的。

接下来通过一个样例，给大家演示 pthread_join() 函数的用法：

#include 
#include    //使用宏 ESRCH
#include 
//线程执行的函数
void *ThreadFun(void *arg)
{
    pthread_exit("http://c.biancheng.net");//指针类型转换，从char*->void*
}
int main()
{
    int res;
    void * thread_result;
    pthread_t myThread;
    //创建 myThread 线程
    res = pthread_create(&myThread, NULL, ThreadFun, NULL);
    if (res != 0) {
        printf("线程创建失败");
        return 0;
    }
    //阻塞主线程，等待 myThread 线程执行结束
    res = pthread_join(myThread, &thread_result);
    if (res != 0) {
        printf("1：等待线程失败");
    }
    //输出获取到的 myThread 线程的返回值
    printf("%s\n", (char*)thread_result);//指针类型转换,从void*->char*
    //尝试再次获取 myThread 线程的返回值
    res = pthread_join(myThread, &thread_result);
    if (res == ESRCH) {
        printf("2：等待线程失败，线程不存在");
    }
    return 0;
}

在程序的在主线程（main() 函数）中，我们尝试两次调用 pthread_join() 函数获取 myThread 线程执行结束的返回值。通过执行结果可以看到，第一个 pthread_join() 函数成功执行，而第二个 Pthread_join() 函数执行失败。原因很简单，第一个成功执行的 pthread_join() 函数会使 myThread 线程释放自己占用的资源，myThread 线程也就不复存在，所以第二个 pthread_join() 函数会返回 ESRCH。