clock(3) 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.

CONFORMITÉ

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

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 à <[email protected]> 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> ».