usleep − Interrompre le programme durant un nombre donné de microsecondes.

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

void usleep (unsigned long usec);

/* SUSv2 version */
#define _XOPEN_SOURCE 500
#include <unistd.h>

int usleep(unsigned long usec);

La fonction usleep() suspend l’exécution du programme appelant durant (au moins) usec microsecondes. La période de sommeil peut être allongée par la charge système, par le temps passé à traiter l’appel de fonction, ou par la granularité des temporisations système.

Aucune (BSD). En succès : zéro, en erreur −1 (SUSv2).

EINTR

Sommeil interrompu par un signal.

EINVAL

usec est plus grand que 1.000.000 (sur les systèmes où cela représente une erreur.

BSD 4.3, POSIX.1-2001. La version SUSv2 renvoie un int, et c’est également le prototype de la glibc 2.2.2. Seule l’erreur EINVAL est doncumentée par SUSv2.

Le type useconds_t est un entier non-signé capable de contenir des entiers dans l’intervalle [0,1000000]. Les programmes gagneront en portabiblité en évitant de mentionner ce type explicitement. Utilisez

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

Ce type est défini dans <sys/types.h> inclus par <unistd.h> mais la glibc ne le définit que si _XOPEN_SOURCE a une valeur supérieure ou égale à 500, ou si _XOPEN_SOURCE et _XOPEN_SOURCE_EXTENDED sont définies.

L’interaction entre cette fonction et SIGALRM, ou d’autres fonctions comme alarm(), sleep(), nanosleep(), setitimer(), timer_create(), timer_delete(), timer_getoverrun(), timer_gettime(), timer_settime(), ualarm() est indéfinie.

Cette fonction est obsolète. Utilisez nanosleep(2) ou setitimer(2) à la place.

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

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 11 décembre 1996 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 usleep ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.