event_set

(PECL libevent >= 0.0.1)

event_set — Prepare an event

说明

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

Prepares the event to be used in event_add(). The event is prepared to call the function specified by the callback on the events specified in parameter events, which is a set of the following flags: EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE and EV_PERSIST.

If EV_SIGNAL bit is set in parameter events, the fd is interpreted as signal number.

After initializing the event, use event_base_set() to associate the event with its event base.

In case of matching event, these three arguments are passed to the callback function:

fd: Signal number or resource indicating the stream.
events: A flag indicating the event. Consists of the following flags: EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE and EV_PERSIST.
arg: Optional parameter, previously passed to event_set() as arg.

参数

event: Valid event resource.
fd: Valid PHP stream resource. The stream must be castable to file descriptor, so you most likely won't be able to use any of filtered streams.
events: A set of flags indicating the desired event, can be EV_READ and/or EV_WRITE. The additional flag EV_PERSIST makes the event to persist until event_del() is called, otherwise the callback is invoked only once.
callback: Callback function to be called when the matching event occurs.
arg: Optional callback parameter.

返回值

event_set() returns TRUE on success or FALSE on error.

更新日志

版本	说明
0.0.4	`EV_SIGNAL` support was added.

User Contributed Notes

jille at hexon dot cx 13-May-2011 05:42


If you change your event with event_set() libevent will forget which base your event belongs to. You must call event_base_set() again *before* calling event_add() on it.