| … | |
… | |
| 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 | |
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>). |
|
|
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 | |
| 211 | Returns an integer describing the backend used by libev (EV::BACKEND_SELECT |
253 | Returns an integer describing the backend used by libev (EV::BACKEND_SELECT |
