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 durée approximative 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É

       C89,   C99,   POSIX.1-2001.  POSIX  demande  que  CLOCKS_PER_SEC  soit  égal  à  1 000 000
       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 1 000 000, cette fonction redonnera les mêmes valeurs toutes les 72 minutes environ.

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

       Dans la glibc version 2.17 et antérieures, clock() était construite en utilisant times(2).
       Afin  d'améliorer  la  précision,  cette fonction est construite depuis la version 2.18 en
       utilisant clock_gettime(2) (qui utilise l'horloge CLOCK_PROCESS_CPUTIME_ID).

VOIR AUSSI

       clock_gettime(2), getrusage(2), times(2)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Florentin  Duneau  et  l'équipe francophone de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».