# La classe EvTimer

(PECL ev >= 0.2.0)

## Introduction

Les watchers EvTimer sont des watchers relativement simples qui génèrent un événement après une durée fournie, et, optionnellement, se répètent dans un intervalle régulier.

Les minuteurs sont basés sur un temps réel, aussi, si un minuteur enregistre un événement qui se termine après une heure et ré-initialise l'horloge système à janvier de l'an passé, il sera de nouveau hors délai après une heure (approximativement). "Approximativement" car la détection des sauts dans le temps est dure, et certaines inexactitudes sont inévitables.

Il est garanti que la fonction de rappel sera appelée uniquement après l'expiration du délai maximal d'attente (et non exactement à ce moment précis, aussi, sur des systèmes avec une horloge basse résolution, il se peut qu'un petit délai soit introduit). Si plusieurs minuteurs deviennent prêts pendant la même itération de boucle, alors celui dont la valeur du délai d'attente maximal sera la plus proche sera invoqué avant l'autre ayant une priorité identique mais avec une valeur du délai d'attente plus éloignée (mais ceci n'est plus vrai lorsqu'une fonction de rappel appelle récursivement la méthode EvLoop::run()).

Le minuteur lui-même va faire tout ce qu'il lui est possible pour ne pas dériver, mais, si un minuteur est configuré pour se lancer toutes les `10` secondes, alors il va normalement se lancer à intervalle de `10` secondes exactement. Cependant, si le script ne peut pas conserver le minuteur car il prend plus de temps que ses `10` secondes, le minuteur ne pourra pas se lancer plus d'une fois par itération de boucle d'événements.

## Synopsis de la classe

class EvTimer extends EvWatcher {
/* Propriétés */
public $repeat;
public $remaining;
/* Propriétés héritées */
public $is_active;
public $data;
public $is_pending;
public $priority;
/* Méthodes */
public function __construct(
float `$after` ,
float `$repeat` ,
callable `$callback` ,
mixed `$data` = `null` ,
int `$priority` = 0
)
public function again(): void
final public static function createStopped(
float `$after` ,
float `$repeat` ,
callable `$callback` ,
mixed `$data` = `null` ,
int `$priority` = 0
): EvTimer
public function set( float `$after` , float `$repeat` ): void
/* Méthodes héritées */
public function EvWatcher::clear(): int
public function EvWatcher::feed( int `$revents` ): void
public function EvWatcher::getLoop(): EvLoop
public function EvWatcher::invoke( int `$revents` ): void
public function EvWatcher::keepalive( bool `$value` = ?): bool
public function EvWatcher::setCallback( callable `$callback` ): void
public function EvWatcher::start(): void
public function EvWatcher::stop(): void
}

## Propriétés

repeat
  Si cette propriété vaut `0.0`, alors il sera automatiquement stoppé une fois le délai maximal d'attente atteint. S'il est positif, alors le minuteur sera automatiquement configuré à se lancer à chaque seconde en suivant, tant qu'il ne sera pas stoppé manuellement.
remaining
  Retourne le temps restant avant que le minuteur ne se lance. Si le minuteur est actif, alors ce temps sera relatif au temps de la boucle d'événements courante, sinon, il sera relatif à la valeur du délai d'attente maximal actuellement configuré. Aussi, après l'instanciation d'un EvTimer avec une valeur de `after` à `5.0` et une valeur de `repeat` à `7.0`, remaining retournera `5.0`. Lorsque le minuteur est démarré, et qu'une seconde se passe, remaining retourne `4.0`. Lorsque le minuteur expire et qu'il est redémarré, il retournera approximativement `7.0` (probablement un peu moins sachant que l'invocation de la fonction de rappel prend un peu de temps aussi), et ainsi de suite.

## Sommaire

- EvTimer::again — Re-démarre le watcher Timer
- EvTimer::__construct — Construit un objet EvTimer watcher
- EvTimer::createStopped — Crée un objet EvTimer watcher stoppé
- EvTimer::set — Configure le watcher

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open