php8.5
Home/ Manual/ ev / evtimer/ EvTimer::createStopped

EvTimer::createStopped

PHP function Edit on GitHub ✎

(PECL ev >= 0.2.0)

Creates EvTimer stopped watcher object

Description

EvTimer::createStopped(float $after, float $repeat, callable $callback, mixed $data = null, int $priority = 0): EvTimer

Creates EvTimer stopped watcher object. Unlike EvTimer::__construct, this method doesn't start the watcher automatically.

Parameters

after

Configures the timer to trigger after after seconds.

repeat

If repeat is 0.0, then it will automatically be stopped once the timeout is reached. If it is positive, then the timer will automatically be configured to trigger again every repeat seconds later, until stopped manually.

callback

See Watcher callbacks.

data

Custom data associated with the watcher.

priority

Watcher priority

Return Values

Returns EvTimer watcher object on success.

Examples

Monitor changes of /var/log/messages. Avoid missing updates by means of one second delay

php
<?php
$timer = EvTimer::createStopped(0., 1.02, function ($w) {
    $w->stop();

    $stat = $w->data;

    // 1 second after the most recent change of the file
    printf("Current size: %ld\n", $stat->attr()['size']);
});

$stat = new EvStat("/var/log/messages", 0., function () use ($timer) {
    // Reset timer watcher
    $timer->again();
});

$timer->data = $stat;

Ev::run();
?>

See Also

  • EvTimer::__construct
  • EvPeriodic

Source: reference/ev/evtimer/createstopped.xml · from the official PHP manual (php/doc-en)