TIMERADD

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 31 juillet 2007
Index Menu principal  

NOM

timeradd, timersub, timercmp, timerclear, timerisset - Opérations sur les structures timeval  

SYNOPSIS

#include <sys/time.h>

void timeradd(struct timeval *a, struct timeval *b,
              struct timeval *res);

void timersub(struct timeval *a, struct timeval *b,
              struct timeval *res);

void timerclear(struct timeval *tvp);

void timerisset(struct timeval *tvp);

void timercmp(struct timeval *a, struct timeval *b, CMP);

Exigences de macros de test de fonctionnalités pour la glibc (voir feature_test_macros(7)) :

Pour toutes les fonctions décrites ci-dessus : _BSD_SOURCE  

DESCRIPTION

Ces macros sont fournies pour travailler sur des structures timeval définies dans <sys/time.h> ainsi :

struct timeval {
    time_t      tv_sec;     /* secondes */
    suseconds_t tv_usec;    /* microsecondes */
};

timeradd() ajoute les valeurs de type temps a et b, et place la somme dans la structure timeval pointée par res. Le résultat est normalisé de telle sorte que res->tv_usec ait une valeur comprise entre 0 et 999 999.

timersub() soustrait la valeur de type temps b de la valeur de type temps a, et place le résultat dans la structure timeval pointée par res. Le résultat est normalisé de telle sorte que res->tv_usec ait une valeur comprise entre 0 et 999 999.

timerclear() réinitialise à zéro la structure timeval pointée par tvp, de telle sorte qu'elle représente le temps à minuit le matin du 1er janvier 1970 (l'Époque).

timerisset() renvoie vrai (non nul) si au moins un des deux champs de la structure timeval pointée par tvp contient une valeur non nulle.

timercmp() compare les valeurs de type temps a et b en utilisant l'opérateur de comparaison CMP, et renvoie vrai (non nul) ou faux (0) suivant le résulat de la comparaison.  

VALEUR RENVOYÉE

timerisset() et timercmp() renvoient vrai (non nul) ou faux (0).  

ERREURS

Aucune erreur n'est définie.  

CONFORMITÉ

Pas dans POSIX.1-2001. Présentes sur la plupart des dérivés BSD.  

VOIR AUSSI

gettimeofday(2), time(7).  

TRADUCTION

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 21 décembre 2007 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 timeradd ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

 

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
VOIR AUSSI
TRADUCTION

Dernière mise à jour : 17 juillet 2008