名称

usleep — マイクロ秒で測った間隔 (インターバル) プロセス実行を一時停止する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < unistd.h>

int
usleep( useconds_t microseconds);

解説

usleep() 関数は、 microseconds マイクロ秒が経過するか、またはシグナルがプロセスに配信されるまで、呼び出しているプロセスの実行をサスペンド (一時停止) します、そしてその動作は、シグナル捕獲関数を呼び出すか、またはプロセスを終了することです。システムの活動は、決っていない値スリープ (sleep) を長くするかもしれません。

この関数は、 microseconds マイクロ秒またはシグナルが起こるまで停止する nanosleep(2) を使用して実装されています。従って、この実装では、スリープは、プロセスタイマの状態に影響はなく、 SIGALRM のための特別な扱いはありません。

戻り値

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

エラー

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

[ EINTR]

シグナルがプロセスに配信され、その動作は、シグナル捕獲関数を呼び出すことでした。

関連項目

nanosleep(2), sleep(3)

歴史

usleep() 関数は、 4.3BSD で登場しました。