usleep - ライブラリコールの説明 - Linux コマンド集 一覧表

usleep - マイクロ秒単位で実行を延期する

/* BSD version */
"#include <unistd.h>"


void usleep(unsigned long usec);


/* SUSv2 version */
"#define _XOPEN_SOURCE 500"


"#include <unistd.h>"


int usleep(useconds_t usec);

usleep () 関数は (少なくとも)usec マイクロ秒の間、 呼び出し元プロセスの実行を延期する。 システムの動作状況や呼び出しによる時間の消費やシステムタイマの粒度によって、 停止時間は設定した値よりも少し延ばされるかもしれない。

なし(BSD 版の場合) または: 成功時に 0、エラー時に -1 (SUSv2 版の場合)。

EINTR

シグナルによって中断された。

EINVAL

usec が 1000000 以上だった。 (これがエラーと考えるシステムのみ)

4.3BSD, POSIX.1-2001. SUSv2 では int を返すことになっており、 glibc 2.2.2 が使っているプロトタイプもそのようになっている。 エラーとして EINVAL を返すというのは SUSv2 でのみ文書化されている。

useconds_t 型は [0,1000000] の範囲の整数を扱うことができる 符号なし整数型である。 明示的にこの型を使わないことでプログラムの移植性がより高まる。 以下のように使うこと。

#include <unistd.h>
...
	unsigned int usecs;
...
	usleep(usecs);

この型は <unistd.h> からインクルードされている <sys/types.h> で定義されている。 しかし glibc は _XOPEN_SOURCE の値が 500 以上か、 _XOPEN_SOURCE と _XOPEN_SOURCE_EXTENDED の両方が定義されている場合にのみ定義する。

この関数と、SIGALRM シグナルあるいは alarm (), sleep (), nanosleep (), setitimer (), timer_create (), timer_delete (), timer_getoverrun (), timer_gettime (), timer_settime (), ualarm ()といったその他のタイマー関数を同時に使った場合の動作は未定義である。

この関数は古いものである。 代わりに   nanosleep (2) または setitimer (2)を使うこと。

  alarm (2),   getitimer (2),   nanosleep (2),   select (2),  setitimer (2),  sleep (3),   feature_test_macros (7)