| … | |
… | |
| 456 | each time the periodic watcher gets scheduled, the reschedule |
456 | each time the periodic watcher gets scheduled, the reschedule |
| 457 | callback ($reschedule_cb) will be called with the watcher as |
457 | callback ($reschedule_cb) will be called with the watcher as |
| 458 | first, and the current time as second argument. |
458 | first, and the current time as second argument. |
| 459 | |
459 | |
| 460 | *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 |
| 461 | 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 |
| 462 | stop it afterwards. |
463 | stop it afterwards. You may create and start a "EV::prepare" |
|
|
464 | watcher for this task. |
| 463 | |
465 | |
| 464 | 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 |
| 465 | 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 |
| 466 | second argument). It will usually be called just before the |
468 | to to the second argument). It will usually be called just |
| 467 | callback will be triggered, but might be called at other times, |
469 | before the callback will be triggered, but might be called at |
| 468 | too. |
470 | other times, too. |
| 469 | |
471 | |
| 470 | 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 |
| 471 | that triggers on each midnight, local time (actually 24 hours |
473 | that triggers on each midnight, local time (actually 24 hours |
| 472 | 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 |
| 473 | 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 |
