IO::Notification::Change Reference

Changes in a file, produced by watch-file

What it is #

Routines #

Signatures are reproduced from the documentation, including their declared return types. A routine listed here is part of the type's published interface; whether Raku++ implements it is a separate question, answered by the examples below.

method path #

Returns the path of the file that's being watched.

method event #

Returns the type of event: FileChanged or FileRenamed.

method IO #

Returns a handle of the file that's being watched.

method gist #

multi method gist(IO::Notification::Change:D:)

Returns the path and event attributes, separated by semicolon.

Examples, run three ways #

Every example below comes from the official documentation, together with the output that documentation asserts. Each was then executed by Rakudo and by Raku++ when this page was built. Where the three agree, one result is shown; where they do not, all three are — because which of them is wrong is exactly the information worth having.

2 no-output

class IO::Notification::Change {}

my $finish = Promise.new;
my $count = 0;
IO::Notification.watch-path($*CWD).act( -> $change {
$count++ if $change.event ~~ FileChanged;
say "($count) $change.path(): $change.event()";
$finish.keep if $count >= 10;
});
await $finish;