event_set

(PECL libevent >= 0.0.1)

event_set — Prépare un évènement

Description

bool event_set ( resource $event , mixed $fd , int $events , mixed $callback [, mixed $arg ] )

Prépare un évènement pour être utilisé avec event_add(). L'évènement est préparé à appeler la fonction précisée dans callback sur les évènements spécifiés dans events, qui sont une liste de drapeaux : EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE et EV_PERSIST.

Si EV_SIGNAL est spécifiée dans le paramètre events, alors fd est interprété comme numéro de signal.

Après initialisation de l'évènement, utilisez event_base_set() pour associer l'évènement avec sa base.

Dans le cas d'un évènement qui correspond, ces trois arguments sont passés à la fonction callback:

fd: Numéro de signal ou ressource représentant le flux.
events: Un drapeau qui indique l'évènement. Peut être parmi : EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE et EV_PERSIST.
arg: Paramètre optionnel, précédemment passé à event_set() en tant que arg.

Liste de paramètres

event: Ressource d'évènement valide.
fd: Ressource de flux PHP valide. Le flux doit être transtypable vers un descripteur de fichier , donc vous ne pourrez pas utiliser de filtres de flux la plupart du temps.
events: Un ensemble de drapeaux indiquant l'évènement désiré, peut être EV_READ et/ou EV_WRITE. Le drapeau supplémentaire EV_PERSIST fait persister l'évènement jusqu'à ce que event_del() soit appelée, sinon la fonction de callback n'est invoquée qu'une seule fois.
callback: Fonction de rappel à appeler lorsqu'un évènement correspondant survient.
arg: Paramètres optionnels à passer à la callback.

Valeurs de retour

event_set() retourne TRUE en cas de succès ou FALSE sinon.

Historique

Version	Description
0.0.4	Le support de `EV_SIGNAL` a été ajouté.