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 │
       └────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

VERSIONS

       XSI  demande  que  CLOCKS_PER_SEC  soit  égal  à 1 000 000 indépendamment de la résolution
       réelle.

       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.

STANDARDS

       C11, POSIX.1-2008.

HISTORIQUE

       POSIX.1-2001, C89.

       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).

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.

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⟩.