CLOCK(3)

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 approximation de la durée écoulée 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é pour l'exécution des processus fils dont les statistiques ont été collectées lors d'un appel à 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.

VOIR AUSSI
getrusage(2), times(2)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 23 octobre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 clock ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.