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