ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libev/ev.pod
(Generate patch)

Comparing libev/ev.pod (file contents):
Revision 1.459 by root, Wed Jan 22 01:50:42 2020 UTC vs.
Revision 1.461 by root, Wed Jan 22 12:15:52 2020 UTC

… …
1218with a watcher-specific start function (C<< ev_TYPE_start (loop, watcher 1218with a watcher-specific start function (C<< ev_TYPE_start (loop, watcher
1219*) >>), and you can stop watching for events at any time by calling the 1219*) >>), and you can stop watching for events at any time by calling the
1220corresponding stop function (C<< ev_TYPE_stop (loop, watcher *) >>. 1220corresponding stop function (C<< ev_TYPE_stop (loop, watcher *) >>.
1221 1221
1222As long as your watcher is active (has been started but not stopped) you 1222As long as your watcher is active (has been started but not stopped) you
1223must not touch the values stored in it. Most specifically you must never 1223must not touch the values stored in it except when explicitly documented
1224reinitialise it or call its C<ev_TYPE_set> macro. 1224otherwise. Most specifically you must never reinitialise it or call its
1225C<ev_TYPE_set> macro.
1225 1226
1226Each and every callback receives the event loop pointer as first, the 1227Each and every callback receives the event loop pointer as first, the
1227registered watcher structure as second, and a bitset of received events as 1228registered watcher structure as second, and a bitset of received events as
1228third argument. 1229third argument.
1229 1230
… …
1846must not modify this member even when the watcher is stopped - always use 1847must not modify this member even when the watcher is stopped - always use
1847C<ev_io_set> for that. 1848C<ev_io_set> for that.
1848 1849
1849=item int events [no-modify] 1850=item int events [no-modify]
1850 1851
1851The set of events being watched, among other flags. This field is a 1852The set of events the fd is being watched for, among other flags. Remember
1852bit set - to test for C<EV_READ>, use C<< w->events & EV_READ >>, and 1853that this is a bit set - to test for C<EV_READ>, use C<< w->events &
1853similarly for C<EV_WRITE>. 1854EV_READ >>, and similarly for C<EV_WRITE>.
1854 1855
1855As with C<fd>, you must not modify this member even when the watcher is 1856As with C<fd>, you must not modify this member even when the watcher is
1856stopped, always use C<ev_io_set> or C<ev_io_modify> for that. 1857stopped, always use C<ev_io_set> or C<ev_io_modify> for that.
1857 1858
1858=back 1859=back
… …
4259method. 4260method.
4260 4261
4261For C<ev::embed> watchers this method is called C<set_embed>, to avoid 4262For C<ev::embed> watchers this method is called C<set_embed>, to avoid
4262clashing with the C<set (loop)> method. 4263clashing with the C<set (loop)> method.
4263 4264
4265For C<ev::io> watchers there is an additional C<set> method that acepts a
4266new event mask only, and internally calls C<ev_io_modfify>.
4267
4264=item w->start () 4268=item w->start ()
4265 4269
4266Starts the watcher. Note that there is no C<loop> argument, as the 4270Starts the watcher. Note that there is no C<loop> argument, as the
4267constructor already stores the event loop. 4271constructor already stores the event loop.
4268 4272

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines