ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/EV/README
(Generate patch)

Comparing EV/README (file contents):
Revision 1.24 by root, Wed Apr 16 17:08:29 2008 UTC vs.
Revision 1.26 by root, Wed May 21 23:40:08 2008 UTC

… …
54 54
55DESCRIPTION 55DESCRIPTION
56 This module provides an interface to libev 56 This module provides an interface to libev
57 (<http://software.schmorp.de/pkg/libev.html>). While the documentation 57 (<http://software.schmorp.de/pkg/libev.html>). While the documentation
58 below is comprehensive, one might also consult the documentation of 58 below is comprehensive, one might also consult the documentation of
59 libev itself (<http://cvs.schmorp.de/libev/ev.html>) for more subtle 59 libev itself (<http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod>)
60 details on watcher semantics or some discussion on the available 60 for more subtle details on watcher semantics or some discussion on the
61 backends, or how to force a specific backend with "LIBEV_FLAGS", or just 61 available backends, or how to force a specific backend with
62 about in any case because it has much more detailed information. 62 "LIBEV_FLAGS", or just about in any case because it has much more
63 detailed information.
64
65 This module is very fast and scalable. It is actually so fast that you
66 can use it through the AnyEvent module, stay portable to other event
67 loops (if you don't rely on any watcher types not available through it)
68 and still be faster than with any other event loop currently supported
69 in Perl.
63 70
64EVENT LOOPS 71EVENT LOOPS
65 EV supports multiple event loops: There is a single "default event loop" 72 EV supports multiple event loops: There is a single "default event loop"
66 that can handle everything including signals and child watchers, and any 73 that can handle everything including signals and child watchers, and any
67 number of "dynamic event loops" that can use different backends (with 74 number of "dynamic event loops" that can use different backends (with
… …
449 each time the periodic watcher gets scheduled, the reschedule 456 each time the periodic watcher gets scheduled, the reschedule
450 callback ($reschedule_cb) will be called with the watcher as 457 callback ($reschedule_cb) will be called with the watcher as
451 first, and the current time as second argument. 458 first, and the current time as second argument.
452 459
453 *This callback MUST NOT stop or destroy this or any other 460 *This callback MUST NOT stop or destroy this or any other
461 periodic watcher, ever, and MUST NOT call any event loop
454 periodic watcher, ever*. If you need to stop it, return 1e30 and 462 functions or methods*. If you need to stop it, return 1e30 and
455 stop it afterwards. 463 stop it afterwards. You may create and start a "EV::prepare"
464 watcher for this task.
456 465
457 It must return the next time to trigger, based on the passed 466 It must return the next time to trigger, based on the passed
458 time value (that is, the lowest time value larger than to the 467 time value (that is, the lowest time value larger than or equal
459 second argument). It will usually be called just before the 468 to to the second argument). It will usually be called just
460 callback will be triggered, but might be called at other times, 469 before the callback will be triggered, but might be called at
461 too. 470 other times, too.
462 471
463 This can be used to create very complex timers, such as a timer 472 This can be used to create very complex timers, such as a timer
464 that triggers on each midnight, local time (actually 24 hours 473 that triggers on each midnight, local time (actually 24 hours
465 after the last midnight, to keep the example simple. If you know 474 after the last midnight, to keep the example simple. If you know
466 a way to do it correctly in about the same space (without 475 a way to do it correctly in about the same space (without
… …
833 course. 842 course.
834 843
835SEE ALSO 844SEE ALSO
836 EV::ADNS (asynchronous DNS), Glib::EV (makes Glib/Gtk2 use EV as event 845 EV::ADNS (asynchronous DNS), Glib::EV (makes Glib/Gtk2 use EV as event
837 loop), EV::Glib (embed Glib into EV), Coro::EV (efficient coroutines 846 loop), EV::Glib (embed Glib into EV), Coro::EV (efficient coroutines
838 with EV), Net::SNMP::EV (asynchronous SNMP). 847 with EV), Net::SNMP::EV (asynchronous SNMP), AnyEvent for event-loop
848 agnostic and portable event driven programming.
839 849
840AUTHOR 850AUTHOR
841 Marc Lehmann <schmorp@schmorp.de> 851 Marc Lehmann <schmorp@schmorp.de>
842 http://home.schmorp.de/ 852 http://home.schmorp.de/
843 853

Diff Legend

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