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.65 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> ».

GNU                                               19 août 2013                                          CLOCK(3)