PTHREAD_TRYJOIN_NP(3) | Linux Programmer's Manual | PTHREAD_TRYJOIN_NP(3) |
名前
pthread_tryjoin_np, pthread_timedjoin_np -終了したスレッドの join を試みる書式
#define _GNU_SOURCE /* See feature_test_macros(7) */
#include <pthread.h>
int pthread_tryjoin_np(pthread_t thread, void **retval);
int pthread_timedjoin_np(pthread_t thread, void **retval,
const struct timespec *abstime);
-pthread を付けてコンパイルとリンクを行う。
説明
これらの関数は pthread_join(3) と同じように動作するが、このページで説明する違いがある。struct timespec {
time_t tv_sec; /* seconds */
long tv_nsec; /* nanoseconds */
};
返り値
成功すると、これらの関数は 0 を返す。エラーの場合、エラー番号を返す。エラー
これらの関数は pthread_join(3) と同じエラーで失敗する。 pthread_tryjoin_np() はさらに以下のエラーで失敗する場合がある。- EBUSY
- 呼び出しを行った時点では thread はまだ終了していない。
pthread_timedjoin_np() はさらに以下のエラーで失敗する場合がある。
- ETIMEDOUT
- thread が終了する前に呼び出しがタイムアウトとなった。
pthread_timedjoin_np() がエラー EINTR を返すことはない。
バージョン
これらの関数は glibc バージョン 2.3.3 で初めて登場した。準拠
これらの関数は非標準の GNU による拡張である。そのため、名前に "_np" (nonportable;移植性がない) という接尾辞が付いている。例
以下のコードは、最大 5 秒まで join を待つ。struct timespec ts;
int s;
...
if (clock_gettime(CLOCK_REALTIME, &ts) == -1) {
/* Handle error */
}
ts.tv_sec += 5;
s = pthread_timedjoin_np(thread, NULL, &ts);
if (s != 0) {
/* Handle error */
}
関連項目
clock_gettime(2), pthread_exit(3), pthread_join(3), pthreads(7)この文書について
この man ページは Linux man-pages プロジェクトのリリース 3.51 の一部である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。2010-09-10 | Linux |