NOM

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

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

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.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).

       ┌────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │Interface                                               │ Attribut             │ Valeur  │
       ├────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │clock()                                                 │ Sécurité des threads │ MT-Safe │
       └────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       POSIX.1-2001,  POSIX.1-2008,  C99.  XSI  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 glibc 2.18 en
       utilisant clock_gettime(2) (qui utilise l'horloge CLOCK_PROCESS_CPUTIME_ID).

VOIR AUSSI

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

TRADUCTION

       La traduction française de cette  page  de  manuel  a  été  créée  par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>, Thierry
       Vignaud <tvignaud@mandriva.com>, François Micaux, Alain  Portal  <aportal@univ-montp2.fr>,
       Jean-Philippe    Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-
       luc.coulon@wanadoo.fr>,   Julien    Cristau    <jcristau@debian.org>,    Thomas    Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,  Denis
       Barbier  <barbier@debian.org>,  David  Prévot  <david@tilapin.org>  et  Jean-Pierre Giraud
       <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.