clock(3) Library Functions Manual clock(3)
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 pro-
gramme ; il faut donc utiliser la différence entre la valeur actuelle
et celle de clock() au lancement du programme pour obtenir une portabi-
lité 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 équi-
valente). Linux n'inclut pas le temps des enfants attendus dans la va-
leur 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)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.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.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org> et David Prévot <david@tilapin.org>
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⟩.
Pages du manuel de Linux 6.03 29 décembre 2022 clock(3)
Generated by dwww version 1.15 on Sat Jun 29 01:45:24 CEST 2024.