名 前
pthread_yield − プ ロ セ ッ サ を 明 け 渡 す (yield)
書 式
#define
_GNU_SOURCE /* See feature_test_macros(7) */
#include <pthread.h>
int pthread_yield(void);
−pthread を 付 け て コ ン パ イ ル と リ ン ク を 行 う 。
説 明
pthread_yield() を 呼 び 出 す と 、 呼 び 出 し た ス レ ッ ド は CPU を 手 放 す 。 ス レ ッ ド は そ の ス レ ッ ド の 静 的 優 先 度 の 実 行 キ ュ ー の 末 尾 に 回 り 、 別 の ス レ ッ ド が 実 行 さ れ る よ う に ス ケ ジ ュ ー リ ン グ さ れ る 。 詳 細 は sched_yield(2) を 参 照 。
返 り 値
成 功 す る と 、 pthread_yield() は 0 を 返 す 。 エ ラ ー の 場 合 、 エ ラ ー 番 号 を 返 す 。
エ ラ ー
Linux で は 、 こ の 関 数 の 呼 び 出 し は 常 に 成 功 す る (た だ し 、 移 植 性 や 将 来 も 動 作 す る こ と を 保 証 し た い ア プ リ ケ ー シ ョ ン で は 正 の エ ラ ー の 返 り 値 を 処 理 す る よ う に す べ き で あ る )。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )
pthread_yield() 関 数 は ス レ ッ ド セ ー フ で あ る 。
準 拠
こ の 関 数 は 非 標 準 だ が 、 他 の い く つ か の シ ス テ ム に も 存 在 す る 。 代 わ り に 、 標 準 化 さ れ て い る sched_yield(2) を 使 う こ と 。
注 意
Linux で は 、 こ の 関 数 は sched_yield(2) を 呼 び 出 す 形 で 実 装 さ れ て い る 。
関 連 項 目
sched_yield(2), pthreads(7), sched(7)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。