Provided by: manpages-fr-dev_4.26.0-1_all bug

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).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ InterfaceAttributValeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ 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 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.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                           clock(3)