| … | |
… | |
| 80 | |
80 | |
| 81 | no warnings; |
81 | no warnings; |
| 82 | use strict; |
82 | use strict; |
| 83 | |
83 | |
| 84 | BEGIN { |
84 | BEGIN { |
| 85 | our $VERSION = '3.48'; |
85 | our $VERSION = '3.6'; |
| 86 | use XSLoader; |
86 | use XSLoader; |
| 87 | XSLoader::load "EV", $VERSION; |
87 | XSLoader::load "EV", $VERSION; |
| 88 | } |
88 | } |
| 89 | |
89 | |
| 90 | @EV::IO::ISA = |
90 | @EV::IO::ISA = |
| … | |
… | |
| 125 | will then also service the kqueue loop to some extent. See the example in |
125 | will then also service the kqueue loop to some extent. See the example in |
| 126 | the section about embed watchers for an example on how to achieve that. |
126 | the section about embed watchers for an example on how to achieve that. |
| 127 | |
127 | |
| 128 | =over 4 |
128 | =over 4 |
| 129 | |
129 | |
| 130 | =item $loop = new EV::loop [$flags] |
130 | =item $loop = new EV::Loop [$flags] |
| 131 | |
131 | |
| 132 | Create a new event loop as per the specified flags. Please refer to |
132 | Create a new event loop as per the specified flags. Please refer to |
| 133 | the C<ev_loop_new ()> function description in the libev documentation |
133 | the C<ev_loop_new ()> function description in the libev documentation |
| 134 | (L<http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#GLOBAL_FUNCTIONS>, |
134 | (L<http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#GLOBAL_FUNCTIONS>, |
| 135 | or locally-installed as F<EV::libev> manpage) for more info. |
135 | or locally-installed as F<EV::libev> manpage) for more info. |
| … | |
… | |
| 201 | =item $time = $loop->now |
201 | =item $time = $loop->now |
| 202 | |
202 | |
| 203 | Returns the time the last event loop iteration has been started. This |
203 | Returns the time the last event loop iteration has been started. This |
| 204 | is the time that (relative) timers are based on, and referring to it is |
204 | is the time that (relative) timers are based on, and referring to it is |
| 205 | usually faster then calling EV::time. |
205 | usually faster then calling EV::time. |
|
|
206 | |
|
|
207 | =item EV::now_update |
|
|
208 | |
|
|
209 | =item $loop->now_update |
|
|
210 | |
|
|
211 | Establishes the current time by querying the kernel, updating the time |
|
|
212 | returned by C<EV::now> in the progress. This is a costly operation and |
|
|
213 | is usually done automatically within C<EV::loop>. |
|
|
214 | |
|
|
215 | This function is rarely useful, but when some event callback runs for a |
|
|
216 | very long time without entering the event loop, updating libev's idea of |
|
|
217 | the current time is a good idea. |
|
|
218 | |
|
|
219 | =item EV::suspend |
|
|
220 | |
|
|
221 | =item $loop->suspend |
|
|
222 | |
|
|
223 | =item EV::resume |
|
|
224 | |
|
|
225 | =item $loop->resume |
|
|
226 | |
|
|
227 | These two functions suspend and resume a loop, for use when the loop is |
|
|
228 | not used for a while and timeouts should not be processed. |
|
|
229 | |
|
|
230 | A typical use case would be an interactive program such as a game: When |
|
|
231 | the user presses C<^Z> to suspend the game and resumes it an hour later it |
|
|
232 | would be best to handle timeouts as if no time had actually passed while |
|
|
233 | the program was suspended. This can be achieved by calling C<suspend> |
|
|
234 | in your C<SIGTSTP> handler, sending yourself a C<SIGSTOP> and calling |
|
|
235 | C<resume> directly afterwards to resume timer processing. |
|
|
236 | |
|
|
237 | Effectively, all C<timer> watchers will be delayed by the time spend |
|
|
238 | between C<suspend> and C<resume>, and all C<periodic> watchers |
|
|
239 | will be rescheduled (that is, they will lose any events that would have |
|
|
240 | occured while suspended). |
|
|
241 | |
|
|
242 | After calling C<suspend> you B<must not> call I<any> function on the given |
|
|
243 | loop other than C<resume>, and you B<must not> call C<resume> |
|
|
244 | without a previous call to C<suspend>. |
|
|
245 | |
|
|
246 | Calling C<suspend>/C<resume> has the side effect of updating the event |
|
|
247 | loop time (see C<now_update>). |
| 206 | |
248 | |
| 207 | =item $backend = EV::backend |
249 | =item $backend = EV::backend |
| 208 | |
250 | |
| 209 | =item $backend = $loop->backend |
251 | =item $backend = $loop->backend |
| 210 | |
252 | |
