Provided by: manpages-fr_1.67.0-1_all bug

NOM

       clock - Déterminer la durée d’utilisation du processeur.

SYNOPSIS

       #include <time.h>

       clock_t clock (void);

DESCRIPTION

       La  fonction  clock()  renvoie  une  approximation  de la durée écoulée
       d’utilisation du processeur par le programme.

VALEUR RENVOYÉE

       La valeur renvoyée  est  le  temps  CPU  écoulé,  en  unités  d’horloge
       clock_t,   pour   obtenir   une   durée  en  secondes,  divisez-la  par
       CLOCKS_PER_SEC.  Si l’heure processeur n’est pas disponible, ou  si  sa
       valeur  ne  peut  pas être représentée correctement, la valeur renvoyée
       est (clock_t)-1.

CONFORMITÉ

       ANSI  C.   POSIX  demande  que  CLOCKS_PER_SEC  soit  égal  à   1000000
       indépendamment de la résolution réelle.

NOTES

       Le  standard  C  autorise  une  valeur quelconque d’horloge au début du
       programme, il faut donc utiliser la différence entre la valeur actuelle
       et  celle  de  clock()  au  lancement  du  programme  pour  obtenir une
       portabilité maximale.

       Notez que la valeur peut revenir  à  zéro.  Sur  un  système  32  bits,
       lorsque CLOCKS_PER_SEC vaut 1000000, cette fonction redonnera les mêmes
       valeurs toutes les 72 minutes environ.

       Sur plusieurs autres implémentations, la valeur  renvoyée  par  clock()
       inclue  aussi  le temps écoulé pour l’exécution des processus fils dont
       les statistiques ont été collectées  lors  d’un  appel  de  la  famille
       wait(2).   Linux  n’inclut  pas  le  temps des enfants attendus dans la
       valeur renvoyée par clock().   La  fonction  times(),  qui  renvoie  de
       manière  explicite et distinctes les informations sur l’appelant et ses
       enfants peut être préférable.

VOIR AUSSI

       getrusage(2), times(2)

TRADUCTION

       Christophe Blaess, 1996-2003.