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ète 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ée, il sera de nouveau hors délai après une heure (approximativement). "Approximativement" car la détection des sauts dans le temps est dur, et certaines inexactitudes sont inévitables.
Il est garantie 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 ne soit introduit). Si plusieurs minuteurs deviennent prêts pendant la même itération de boucle, alors celui dont les valeurs 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 se lancer pas plus d'une fois par itération de boucle
d'événements.
Synopsis de la classe
$after
,
float
$repeat
,
callable
$callback
[,
mixed
$data
= NULL
[,
int
$priority
= 0
]] )$after
,
float
$repeat
,
callable
$callback
[,
mixed
$data
= NULL
[,
int
$priority
= 0
]] )Propriétés
- repeat
-
Si cette propriété vaut
0.0
, alors il sera automatiquement stoppée 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 derepeat
à7.0
, remaining retournera5.0
. Lorsque le minuteur est démarré, et qu'une seconde se passe, remaining va retourner4.0
. lorsque le minuteur expire et qu'il est redémarré, il retournera approximativement7.0
(probablement un peu moins sachant que l'onvocation 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
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-class.evtimer.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.