The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

File::RegexMatch::File - Object to represent a file.

SYNOPSIS

    #!/usr/bin/env perl -w

    use strict;
    use File::RegexMatch::File;

    File::RegexMatch::File->new(path => '/path/to/file');

DESCRIPTION

This module allows each file that has been located by File::RegexMatch to be represented by an object. The object has methods for retrieving information about the file using the File::stat module. There are different levels of support for certain filesystems. See stat for further information.

METHODS

new

Constructor for the object. Takes one parameter, which is the path of the file. The library will croak if stat cannot be called on the file path.

path

Returns the absolute path of the file.

dev

Returns the device number of the filesystem.

ino

Returns the inode number.

mode

Returns the type and permissions of the file.

Returns the number of hard links to the file.

uid

Returns the numeric user ID of the file owner.

gid

Returns the numeric group ID of the file owner.

rdev

Returns the device identifer.

size

Returns the total size of the file in bytes.

atime

Returns the last access time in seconds since the epoch.

mtime

Returns the last modify time in seconds since the epoch.

ctime

Returns the incode change time in seconds since the epoch.

blksize

Returns the preferred I/O size in bytes for interacting with the file.

blocks

Returns the actual number of system-specific blocks allocated on the disk.

SEE ALSO

File::stat

stat

BUGS

Please report any bugs or feature requests to lloydg@cpan.org

AUTHOR

Lloyd Griffiths

COPYRIGHT

Copyright (c) 2013 Lloyd Griffiths

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