pthread_join()函数

pthread_join

目 录

1函数简介

2函数应用

1. 2.1 linux中的应用
2. 2.2 pthread_join的应用

3使用范例

1函数简介

函数 pthread_join用来等待一个线程的结束。

头文件 ： #include <pthread.h>

函数定义： int  pthread_join(pthread_t thread, void **retval);

描述 ：

pthread_join()函数，以阻塞的方式等待thread指定的线程结束。当函数返回时，被等待线程的资源被收回。如果进程已经结束，那么该函数会立即返回。并且thread指定的线程必须是joinable的。

参数 ：

thread: 线程 标识符，即线程ID，标识唯一线程。

retval: 用户定义的指针，用来存储被等待线程的返回值。

返回值 ： 0代表成功。 失败，返回的则是错误号。 ^[1]

2函数应用

linux中的应用

在 Linux中，默认情况下是在一个 线程被创建后，必须使用此函数对创建的线程进行资源回收，但是可以设置Threads attributes来设置当一个线程结束时，直接回收此线程所占用的 系统资源，详细资料查看Threads attributes。

其实在Linux中，新建的线程并不是在原先的进程中，而是系统通过一个 系统调用clone()。该系统copy了一个和原先进程完全一样的进程，并在这个进程中执行线程函数。不过这个copy过程和fork不一样。 copy后的进程和原先的进程共享了所有的 变量，运行环境。这样，原先进程中的 变量变动在copy后的进程中便能体现出来。

pthread_join的应用

pthread_join使一个线程等待另一个线程结束。

代码中如果没有 pthread_join 主线程会很快结束从而使整个进程结束，从而使创建的线程没有机会开始执行就结束了。加入 pthread_join后， 主线程会一直等待直到等待的线程结束自己才结束，使创建的线程有机会执行。

所有线程都有一个线程号，也就是 Thread ID。其类型为 pthread_t。通过调用 pthread_self()函数可以获得自身的线程号。

3使用范例

一个线程的结束有两种途径，一种是象我们下面的例子一样，函数结束了，调用它的线程也就结束了；另一种方式是通过函数pthread_exit来实现。另外需要说明的是，一个线程不能被多个线程等待，也就是说对一个线程只能调用一次pthread_join，否则只有一个能正确返回，其他的将返回ESRCH 错误。

在Linux中，默认情况下是在一个线程被创建后，必须使用此函数对创建的线程进行资源回收，但是可以设置Threads attributes来设置当一个线程结束时，直接回收此线程所占用的系统资源，详细资料查看Threads attributes。

范例：

//signaltest.c
　　// 子线程阻塞，等待信号，然后输出字符串
　　// 主线程从键盘录入字符，给子线程发信号。

#include <stdio.h>
#include <unistd.h>
#include <signal.h>
#include <pthread.h>
#include <time.h>
pthread_t tid;　sigset_t set;
void myfunc()
{
　printf("hello\n");
}
static void* mythread(void *p)
{
　int signum;
　while(1) {
　  　sigwait(&set,&signum);
  　if(SIGUSR1 == signum)
  　myfunc();
  　if(SIGUSR2 == signum)
    　{
    　 printf("I will sleep 2 second and exit\n");
    　 sleep(2);
    　 break;
    　}
    }
}
int main()
{
  char tmp;
  void* status;
  sigemptyset(&set);
  sigaddset(&set,SIGUSR1);
  sigaddset(&set,SIGUSR2);
  sigprocmask(SIG_SETMASK,&set,NULL);
  pthread_create(&tid,NULL,mythread,NULL);
  while(1)
  {
    printf(":");
    scanf("%c",&tmp);
    if('a' == tmp)
    {
       pthread_kill(tid,SIGUSR1); //发送SIGUSR1，打印字符串。
    }
    else if('q'==tmp)
    {
      //发出SIGUSR2信号，让线程退出，如果发送SIGKILL，线程将直接退出。
      pthread_kill(tid,SIGUSR2);
      //等待线程tid执行完毕，这里阻塞。
      pthread_join(tid,&status); 
      printf("finish\n");
      break;
    }
    else
      continue;
  }
  return 0;
}

运行结果：

// 如果输入a，子线程打印"hello"，主程序继续等待输入；

// 如果输入q，主程序等待子程序结束。子线程打印"I will sleep 2 second and exit"，并延时两秒后结束。主线程随之打印"finish"，程序结束。

在前面我们提到，可以通过pthread_join()函数来使主线程阻塞等待其他线程退出，这样主线程可以清理其他线程的环境。但是还有一些线程，更喜欢自己来清理退出的状态，他们也不愿意主线程调用pthread_join来等待他们。我们将这一类线程的属性称为detached。如果我们在调用pthread_create()函数的时候将属性设置为NULL，则表明我们希望所创建的线程采用默认的属性，也就是joinable。如果需要将属性设置为detached，则参考下面的例子：

void * start_run(void * arg)
{
  //do some work
}
 
int main()
{
  pthread_t thread_id;
  pthread_attr_t attr;
  pthread_attr_init(&attr);
  pthread_attr_setdetachstate(&attr,PTHREAD_CREATE_DETACHED);
  pthread_create(&thread_id,&attr,start_run,NULL);
  pthread_attr_destroy(&attr);
  sleep(5);
  exit(0);
}

在线程设置为joinable后，可以调用pthread_detach()使之成为detached。但是相反的操作则不可以。还
　　有，如果线程已经调用pthread_join()后，则再调用pthread_detach()则不会有任何效果。