pthread_join

pthread_join 是 POSIX 线程库中的一个函数，用于等待指定的线程终止，并获取该线程的退出状态。它允许一个线程等待另一个线程的完成，以便协调线程的执行顺序和获取线程的返回结果。
以下是 pthread_join 函数的详细解析：
函数原型：
int pthread_join(pthread_t thread, void **retval);

函数参数：

1.thread：要等待的线程的线程标识符（pthread_t 类型）。
2.retval：一个指针的指针，用于存储被等待线程的退出状态。

函数说明：

3.pthread_join 函数阻塞当前线程，直到指定的线程终止。
4.当所等待的线程终止后，调用 pthread_join 的线程将被唤醒并继续执行。
5.pthread_join 函数返回后，调用线程可以通过 retval 参数获取被等待线程的退出状态。
6.被等待的线程在终止时必须使用 pthread_exit 函数返回一个退出状态，以便被等待线程能够获取到退出状态。

函数返回值：

7.如果成功等待指定的线程终止，pthread_join 返回 0。
8.如果出现错误，返回非零的错误代码，可以使用 errno 宏获取具体的错误信息。

示例用法：
#include <stdio.h>
#include <pthread.h>

void* thread_function(void* arg) {
    int thread_id = *(int*)arg;
    printf("Thread %d is executing.\n", thread_id);

    // 模拟线程执行时间
    sleep(2);

    // 线程执行完成后退出，返回线程编号
    int* thread_exit_status = malloc(sizeof(int));
    *thread_exit_status = thread_id;
    pthread_exit(thread_exit_status);
}

int main() {
    pthread_t thread1, thread2;
    int thread_id1 = 1, thread_id2 = 2;
    int* thread1_exit_status;
    int* thread2_exit_status;

    pthread_create(&thread1, NULL, thread_function, (void*)&thread_id1);
    pthread_create(&thread2, NULL, thread_function, (void*)&thread_id2);

    pthread_join(thread1, (void**)&thread1_exit_status);
    pthread_join(thread2, (void**)&thread2_exit_status);

    printf("Thread 1 exited with status: %d\n", *thread1_exit_status);
    printf("Thread 2 exited with status: %d\n", *thread2_exit_status);

    free(thread1_exit_status);
    free(thread2_exit_status);

    return 0;
}

在上述示例中，我们创建了两个线程并将它们与 thread_function 关联。在 thread_function 中，我们模拟了线程的执行时间，并通过 pthread_exit 返回了线程的退出状态，即线程的编号。在 main 函数中，我们使用 pthread_join 等待线程的终止，并获取线程的退出状态。
当调用 pthread_join 时，当前线程将阻塞，直到指定的线程终止。在线程终止后，pthread_join 返回，我们可以通过 thread_exit_status 变量获取线程的退出状态，并打印出来。
总结：
pthread_join 函数用于等待指定的线程终止，并获取线程的退出状态。它允许一个线程等待另一个线程的完成，并进行线程间的同步和协调。通过 pthread_join，我们可以确保在需要使用线程的返回结果时，线程已经执行完成并获取到了正确的结果。