TIMERADD(3)

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 fonctionalité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 les 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 a 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 a une valeur comprise entre 0 et 999,999. timerclear() réinitialise à zéro la structure timeval pointée par tvp, ainsi elle représente le temps à minuit 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 23 décembre 2007.

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.