pthread_join()函数

pthread_join()函数作用

控制线程的执行流
等待线程执行结束

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

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

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

pthread_join() 函数会一直阻塞调用它的线程，直至目标线程执行结束（接收到目标线程的返回值），阻塞状态才会解除。如果 pthread_join() 函数成功等到了目标线程执行结束（成功获取到目标线程的返回值），返回值为数字 0；反之如果执行失败，函数会根据失败原因返回相应的非零值，每个非零值都对应着不同的宏，例如：
EDEADLK：检测到线程发生了死锁。关于线程发生死锁，我们会在《Linux如何避免线程发生死锁？》一节中做详细讲解。
EINVAL：分为两种情况，要么目标线程本身不允许其它线程获取它的返回值，要么事先就已经有线程调用 pthread_join() 函数获取到了目标线程的返回值。
ESRCH：找不到指定的 thread 线程。
以上这些宏都声明在 <errno.h> 头文件中，如果程序中想使用这些宏，需提前引入此头文件。

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

#include <stdio.h>
#include <pthread.h>
#include <unistd.h>
#include <errno.h> //使用宏 ESRCH
#include <stdlib.h>
#include <string.h>

// 线程执行的函数
void *thread_main(void *arg);

int main(int argc, char *argv[])
{
    pthread_t t_id;
    int thread_param = 5;
    void *thr_ret;
    int res;
    // 创建 线程
    if (pthread_create(&t_id, NULL, thread_main, (void *)&thread_param) != 0)
    {
        puts("pthread_create() error");
        return -1;
    }

    // 阻塞主线程，等待  线程执行结束
    res = pthread_join(t_id, &thr_ret);
    if (res != 0)
    {
        printf("1.等待线程失败\n");
    }

    //输出获取到的 thread_main 线程的返回值
    printf("%s", (char *)thr_ret);

    res = pthread_join(t_id, &thr_ret);
    if (res == ESRCH)
    {
        printf("2.等待线程失败，线程不存在\n");
    }

    return 0;
}

void *thread_main(void *arg)
{
    int cnt = *((int *)arg);
    int i;
    char *msg = (char *)malloc(sizeof(char) * 50);
    strcpy(msg, "Hi,I'm Groat\n");

    for (i = 0; i < cnt; i++)
    {
        sleep(1);
        printf("running thread\n");
    }

    return (void *)msg;
}

执行结果

总结：
在应用中，用pthread_join()函数控制线程的执行流，阻塞调用它的线程，直至目标线程执行结束（接收到目标线程的返回值），阻塞状态才会解除。这样不使用sleep()也可以让线程正常执行。
还有一个作用是：获取线程的返回值。