Prepara un evento

Descripción

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

Prepara el evento que se va a utilizar en la función event_add(). El evento es preparado para llamar a la función especificada por el parámetro callback en los eventos especificados en el parámetro events, que son un conjunto de los siguientes indicadores: EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE y EV_PERSIST.

Si el bit EV_SIGNAL se especifica en el parámetro events, el parámetro fd se interpreta como un número de señal.

Después de inicializar el evento, utilizar la función event_base_set() para asociar el evento a su base de eventos.

En el caso de que se de un evento, se pasan los siguientes tres argumentos a la función callback :

fd: Número de señal o recurso que indica el flujo.
events: Un indicador que informa el evento. Está formado por los siguientes indicadores: EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE y EV_PERSIST.
arg: Parámetro opcional, pasado previamente a event_set() como arg.

Parámetros

event: Recurso válido de evento.
fd: Recurso válido de flujo PHP . El flujo debe ser tipificable como descriptor de fichero, por lo que no se podrá utilizar ningún flujo filtrado la mayoría de las veces.
events: Un conjunto de indicadores para el evento deseado, pueden ser EV_READ y/o EV_WRITE. El indicador adicional EV_PERSIST hace que el evento sea persistente hasta que se llame la función event_del(), de otro modo la llamada se invoca una sola vez.
callback: Función de llamada que se ejecutará cuando se produzca el evento.
arg: Parámetro opcional de llamada.

Valores devueltos

event_set() devuelve TRUE en caso de éxito o FALSE en caso de error.

Historial de cambios

Versión	Descripción
0.0.4	Se añadió la ayuda de `EV_SIGNAL`.