event_set

(PECL libevent >= 0.0.1)

event_setPrepara un evento

Descripción

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

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.