名称

sem_getvalue — セマフォの値を取得する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < semaphore.h>

int
sem_getvalue( sem_t * restrict sem, int * restrict sval);

解説

sem_getvalue() 関数は、 sem_getvalue() が実際実行されるために呼び出される時間で sval によって指される変数を sem によって指されるセマフォの現在の値に設定します。

戻り値

The sem_getvalue() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

sem_getvalue() 関数は、次の場合に失敗します:

[ EINVAL]

sem 引数が、無効なセマフォを指しています。

関連項目

sem_post(3), sem_trywait(3), sem_wait(3), sem(4)

規格

sem_getvalue() 関数は、 ISO/IEC 9945-1:1996 (“POSIX.1”) に適合しています。

セマフォ上でブロックされたスレッドがあっても、セマフォの値は決して負ではありません。 POSIX は、ブロックされた待ちスレッドがある場合、セマフォの値があるべき何かに関して言葉は少し曖昧です。しかし、この振る舞いは与えられた仕様の言葉と一致します。