NAME

Path::Class::File::Stat - cache and compare stat() calls on a Path::Class::File object

SYNOPSIS

use Path::Class::File::Stat;
my $file = Path::Class::File::Stat->new('path','to','file');

# $file has all the magic of Path::Class::File

# sometime later
if ($file->changed)
{
  # do something provocative
  # and then re-cache the stat of the file
  $file->restat;
}

DESCRIPTION

Path::Class::File::Stat is a simple extension of Path::Class::File. Path::Class::File::Stat is useful in long-running programs (as under mod_perl) where you might have a file handle opened and want to check if the underlying file has changed.

METHODS

Path::Class::File::Stat implements two new methods for Path::Class::File objects.

changed

Returns true if the object's device number and inode number have changed, or if the modification time has changed.

restat

Re-cache the File::stat object in the Path::Class::File::Stat object. Returns the previously cached File::stat object.

SEE ALSO

Path::Class, Path::Class::File

AUTHOR

Peter Karman, <karman@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Peter Karman

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.