名 前
pthread_testcancel − 処 理 待 ち の 取 り 消 し 要 求 の 配 送 を 要 求 す る
書 式
#include <pthread.h>
void pthread_testcancel(void);
−pthread で コ ン パ イ ル し て リ ン ク す る 。
説 明
pthread_testcancel() を 呼 び 出 す と 、 呼 び 出 し た ス レ ッ ド 内 に 取 り 消 し ポ イ ン ト (cancellation point) が 作 成 さ れ る 。 こ れ に よ り 、 こ れ 以 外 に は 取 り 消 し ポ イ ン ト を 含 ま な い コ ー ド を 実 行 し て い る ス レ ッ ド が 取 り 消 し 要 求 に 対 応 す る こ と が で き る よ う に な る 。
(pthread_setcancelstate(3) を 使 っ て ) キ ャ ン セ ル が 無 効 に な っ て い る 場 合 や 処 理 待 ち の 取 り 消 し 要 求 が な い 場 合 は 、 pthread_testcancel() を 呼 び 出 し て も 何 の 影 響 も な い 。
返 り 値
こ の 関 数 は 値 を 返 さ な い 。 こ の 関 数 の 呼 び 出 し の 結 果 、 呼 び 出 し た ス レ ッ ド が キ ャ ン セ ル さ れ た 場 合 、 こ の 関 数 が 返 る こ と は な い 。
エ ラ ー
こ の 関 数 は 常 に 成 功 す る 。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )
pthread_testcancel() 関 数 は ス レ ッ ド セ ー フ で あ る 。
準 拠
POSIX.1−2001.
例
pthread_cleanup_push(3) を 参 照 。
関 連 項 目
pthread_cancel(3), pthread_cleanup_push(3), pthread_setcancelstate(3), pthreads(7)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。