Ev

Introduction

Cette extension fournit une interface à la bibliothèque » libev, une boucle d'événements hautement performante, écrite en C.

Note: Cette extension n'est pas disponible sur les plates-formes Windows.

Libev est une boucle d'événements : elle enregistre un intérêt pour certains événements (comme un descripteur de fichier devenu lisible, ou encore un délai d'attente maximal qui survient), elle va gérer les sources de ces événements, et fournir le programme avec ces événements.

Pour réaliser cela, elle va prendre un contrôle plus ou moins total du processus (ou Thread) en exécutant un gestionnaire de boucle d'événements, puis va les communiquer via un mécanisme de fonction de rappel.

L'enregistrement d'intérêts pour certains événements se fait via des observateurs, puis, redonne la main à libev en démarrant ces observateurs.

Pour plus de détails, se reporter à la » documentation de libev.

Installation/Configuration
- Pré-requis
- Installation
Exemples
Watchers
Les fonctions de rappel d'un Watcher
Modes d'opération périodique d'un watcher
Ev — La classe Ev
- Ev::backend — Retourne un entier décrivant le backend utilisé par libev
- Ev::depth — Retourne la profondeur de récursion
- Ev::embeddableBackends — Retourne le jeu de backends qui sont encapsulés dans les autres boucles d'événements
- Ev::feedSignal — Simule la réception d'un signal
- Ev::feedSignalEvent — Simule un événement de signal dans la boucle par défaut
- Ev::iteration — Retourne le nombre de fois que la boucle d'événement par défaut a été sollicitée pour un nouvel événement
- Ev::now — Retourne le temps de démarrage de la dernière itération de la boucle d'événement par défaut
- Ev::nowUpdate — Établit le temps courant en demandant au kernel ; met à jour le temps retourné par Ev::now pendant l'exécution
- Ev::recommendedBackends — Retourne un masque d'octets de backends recommandés pour la plateforme courante
- Ev::resume — Reprend la boucle d'événement par défaut précédemment stoppée
- Ev::run — Commence la vérification des événements et appelle les fonctions de rappels pour la boucle par défaut
- Ev::sleep — Bloque le processus pendant un nombre de secondes fourni
- Ev::stop — Arrête la boucle d'événements par défaut
- Ev::supportedBackends — Retourne le jeu de backends supportés par la configuration courante de libev
- Ev::suspend — Suspend la boucle par défaut d'événements
- Ev::time — Retourne le temps courant depuis l'époque Unix
- Ev::verify — Effectue des vérifications internes de consistance (pour le débogage)
EvCheck — La classe EvCheck
- EvCheck::__construct — Construit l'objet d'observation EvCheck
- EvCheck::createStopped — Crée une instance d'un observateur stoppé EvCheck
EvChild — La classe EvChild
- EvChild::__construct — Construit l'objet d'observation EvChild
- EvChild::createStopped — Crée une instance de l'observateur stoppé EvCheck
- EvChild::set — Configure l'observateur
EvEmbed — La classe EvEmbed
- EvEmbed::__construct — Construit un objet EvEmbed
- EvEmbed::createStopped — Crée un objet EvEmbed watcher stoppé
- EvEmbed::set — Configure le watcher
- EvEmbed::sweep — Balaye, une seule fois, et de façon non bloquante la boucle interne
EvFork — La classe EvFork
- EvFork::__construct — Construit l'objet observateur EvFork
- EvFork::createStopped — Crée une instance arrêtée de la classe de l'observateur EvFork
EvIdle — La classe EvIdle
- EvIdle::__construct — Construit l'objet observateur EvIdle
- EvIdle::createStopped — Crée une instance d'un objet observateur EvIdle
EvIo — La classe EvIo
- EvIo::__construct — Construit un nouvel objet EvIo
- EvIo::createStopped — Crée un objet d'observateur EvIo arrêté
- EvIo::set — Configure l'observateur
EvLoop — La classe EvLoop
- EvLoop::backend — Retourne un entier décrivant le backend utilisé par libev
- EvLoop::check — Crée un objet EvCheck associé avec l'instance de la boucle d'événements courante
- EvLoop::child — Crée un objet EvChild associé avec la boucle d'événements courante
- EvLoop::__construct — Construit un objet de boucle d'événements
- EvLoop::defaultLoop — Retourne ou crée la boucle d'événements par défaut
- EvLoop::embed — Crée une instance de l'observateur EvEmbed associé avec l'objet de l'EvLoop courant
- EvLoop::fork — Crée un objet EvFork watcher associé avec l'instance de la boucle de l'événement courant
- EvLoop::idle — Crée un objet EvIdle watcher associé avec l'instance de la boucle de l'événement courant
- EvLoop::invokePending — Invoque tous les watchers en attente pendant que leurs statuts de file d'attente ne soient réinitialisés
- EvLoop::io — Crée un objet EvIo watcher associé avec l'instance de la boucle de l'événement courant
- EvLoop::loopFork — Doit être appelé après un fork
- EvLoop::now — Retourne le "event loop time" courant
- EvLoop::nowUpdate — Établit le temps courant en demandant au kernel, et mise à jour du temps retourné par EvLoop::now pendant l'exécution
- EvLoop::periodic — Crée un objet EvPeriodic watcher associé avec l'instance de la boucle d'événement courant
- EvLoop::prepare — Crée un objet EvPrepare watcher associé avec l'instance de la boucle d'événement courant
- EvLoop::resume — Reprend une boucle d'événement précédemment stoppée
- EvLoop::run — Commence à vérifier les événements et à appeler les fonctions de rappel de la boucle
- EvLoop::signal — Crée un objet EvSignal watcher associé avec l'instance de la boucle d'événement courant
- EvLoop::stat — Crée un objet EvStat watcher associé avec l'instance de la boucle d'événement courant
- EvLoop::stop — Stoppe la boucle d'événement
- EvLoop::suspend — Suspend la boucle
- EvLoop::timer — Crée un objet EvTimer watcher associé avec l'instance de la boucle d'événement courant
- EvLoop::verify — Effectue des vérifications de consistance interne (pour le débogage)
EvPeriodic — La classe EvPeriodic
- EvPeriodic::again — Arrête et re-démarre le watcher périodique
- EvPeriodic::at — Retourne le temps absolu auquel ce watcher sera appelé la prochaine fois
- EvPeriodic::__construct — Construit un objet watcher EvPeriodic
- EvPeriodic::createStopped — Crée un watcher EvPeriodic stoppé
- EvPeriodic::set — Configure le watcher
EvPrepare — La classe EvPrepare
- EvPrepare::__construct — Construit un objet de watcher EvPrepare
- EvPrepare::createStopped — Crée une instance stoppée du watcher EvPrepare
EvSignal — La classe EvSignal
- EvSignal::__construct — Construit un objet watcher EvSignal
- EvSignal::createStopped — Crée un objet watcher EvSignal stoppé
- EvSignal::set — Configure le watcher
EvStat — La classe EvStat
- EvStat::attr — Retourne la valeur la plus récente détectée par Ev
- EvStat::__construct — Construit un objet EvStat watcher
- EvStat::createStopped — Crée un objet EvStat watcher stoppé
- EvStat::prev — Retourne le jeu précédent retourné par EvStat::attr
- EvStat::set — Configure le watcher
- EvStat::stat — Initialise l'appel à stat
EvTimer — La classe EvTimer
- 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
EvWatcher — La classe EvWatcher
- EvWatcher::clear — Efface le statut d'attente de l'observateur
- EvWatcher::__construct — Constructeur d'objet observateur
- EvWatcher::feed — Alimente les revents fournis dans la boucle d'événements
- EvWatcher::getLoop — Retourne la boucle responsable de l'observateur
- EvWatcher::invoke — Invoque la fonction de rappel de l'observateur avec le masque de bits des événements reçus fournis
- EvWatcher::keepalive — Garde la boucle active
- EvWatcher::setCallback — Définit une nouvelle fonction de rappel pour le watcher
- EvWatcher::start — Démarre le Watcher
- EvWatcher::stop — Arrête le Watcher