©
This document uses PHP Chinese website manual Release
(PECL libevent >= 0.0.1)
event_set — Prepare an event
$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.
|
[#1] jille at hexon dot cx [2011-05-13 08:42:00]
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.