clock(3)                   Library Functions Manual                   clock(3)

NOM
       clock - Determiner la duree d'utilisation du processeur

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <time.h>

       clock_t clock(void);

DESCRIPTION
       La fonction clock() renvoie une duree approximative d'utilisation du
       processeur par le programme.

VALEUR RENVOYEE
       La valeur renvoyee est le temps CPU ecoule, en unites d'horloge
       clock_t, pour obtenir une duree en secondes, divisez-la par
       CLOCKS_PER_SEC. Si l'heure processeur n'est pas disponible, ou si sa
       valeur ne peut pas etre representee correctement, la valeur renvoyee
       est (clock_t) -1.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |clock()                          | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
VERSIONS
       XSI demande que CLOCKS_PER_SEC soit egal a 1 000 000 independamment de
       la resolution reelle.

       Sur plusieurs autres implementations, la valeur renvoyee par clock()
       inclut aussi le temps ecoule par l'execution des processus fils dont
       les statistiques ont ete collectees par wait(2) (ou une fonction
       equivalente). Linux n'inclut pas le temps des enfants attendus dans la
       valeur renvoyee par clock(). La fonction times(2), qui renvoie de
       maniere explicite et distinctes les informations sur l'appelant et ses
       enfants, peut etre preferable.

STANDARDS
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C89.

       Dans la glibc version 2.17 et anterieures, clock() etait construite en
       utilisant times(2). Afin d'ameliorer la precision, 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 debut du
       programme ; il faut donc utiliser la difference entre la valeur
       actuelle et celle de clock() au lancement du programme pour obtenir une
       portabilite maximale.

       Notez que la valeur peut revenir a zero. Sur un systeme 32 bits,
       lorsque CLOCKS_PER_SEC vaut 1 000 000, cette fonction redonnera les
       memes valeurs toutes les 72 minutes environ.

VOIR AUSSI
       clock_gettime(2), getrusage(2), times(2)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       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 RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                       clock(3)