pthread_join函数

函数原型：int pthread_join(pthread_t tid, void **status);

功能：pthread_join()函数会一直阻塞调用线程，直到指定的线程tid终止。当pthread_join()返回之后，应用程序可回收

与已终止线程关联的任何数据存储空间，（另外也可设置线程attr属性，当线程结束时直接回收资源）如果没有必要等待特定的线程

终止之后才进行其他处理，则应当将该线程分离pthread_detach()。

头文件：#include <pthread.h>

pthread非linux系统的默认库， 需手动链接-线程库 -lpthread

参数：

tid：需要等待的线程,指定的线程必须位于当前的进程中，而且不得是分离线程

status:线程tid所执行的函数start_routine的返回值（start_routine返回值地址需要保证有效），其中status可以为nullptr

返回值：

调用成功完成后，pthrea_join()返回0.其他任何返回值都表示出现了错误。如果检测到以下任意情况

pthread_join()将失败并返回相应的值

ESRCH
描述: 没有找到与给定的线程ID 相对应的线程。（如果多个线程等待同一个线程终止，则所有等待线程将一直等到目标线程终止。

然后一个等待线程成功返回。其余的等待线程将失败返回ESRCH错误）
EDEADLK
描述: 将出现死锁，如一个线程等待其本身，或者线程A和线程B 互相等待。
EINVAL
描述: 与给定的线程ID 相对应的线程是分离线程。

代码：

#include <iostream>
#include <pthread.h>
#include <cstdlib>
#include <string>
#include <unistd.h>
using std::cout;
using std::cin;
using std::cerr;
using std::endl;
using std::string;
struct info
{
	string name;
	unsigned s_time;//sleep时间
};
void *start_routine(void *arg)
{
	info *t_arg = (info *) arg;
	for(unsigned i = 0; i != 5U; ++i)
	{
		cout << t_arg->name << endl;
		sleep(t_arg->s_time);
	}
	return (void *)t_arg;
}
constexpr unsigned THREAD_N = 2;//线程的数量
int main()
{
	pthread_t tid[THREAD_N];
	//pthread_attr_t *attr1 = nullptr, *attr2 = nullptr;
	int ret[THREAD_N];
	info args[THREAD_N] = {"Win", 1U, "Unix", 2U};
   	for(unsigned i = 0; i != THREAD_N; ++i)
   	{
		/*
		   pthread_attr_t attr;
		   ret[i] = pthread_create(&tid[i], &attr, &start_routine, &args[i]);
		   attr需由pthread_attr_init()进行初始化，此处产生了EAGAIN错误
		 */
		ret[i] = pthread_create(&tid[i], nullptr, &start_routine, &args[i]);
		if(ret[i] != 0)
		{
			if(ret[i] == EAGAIN)
			{
				cerr << args[i].name << " : 超出系统限制" << endl;
			}	
			else if(ret[i] == EINVAL)
			{
				cerr << args[i].name << " : pthread_attr_t设置无效" << endl;
			}
			else 
			{
				cerr << args[i].name << ": unkown error" << endl;
			}	
			exit(-1);
		}
	}
	/*
		对于pthread_join(),如果线程tid的start_routine已经执行完毕，
		pthrea_join仍能正常返回，这说明start_routine执行完毕后线程
		资源并没有被收回
	*/
	void *status[THREAD_N];
	for(unsigned i = 0; i != THREAD_N; ++i)
	{
		ret[i] = pthread_join(tid[i], &status[i]);
		if(ret[i] != 0)
		{
			if(ret[i] == ESRCH)
			{
				cerr << "pthread_join():ESRCH 没有找到与给定线程ID相对应的线程" << endl;
			}
			else if(ret[i] == EDEADLK)
			{
				cerr << "pthread_join():EDEADLKI 产生死锁" << endl;
			}
			else if(ret[i] == EINVAL)
			{
				cerr << "pthread_join():EINVAL 与给定的县城ID相对应的线程是分离线程" << endl;
			}
			else
			{
				cerr << "pthread_join():unknow error" << endl;
			}
			exit(-1);
		}
	}
	/*
		ret[0] = pthread_join(tid[0], &status[0]);
		cerr << (ret[0] == ESRCH);
		由于线程tid[0]的资源已被收回，所以此处产生ESRCH
	*/
	return 0;
}