Abstracts a file from the filesystem.


new( $filename )

Opens the file specified by $filename and returns a filehandle and a flag that says whether it could be binary.

If there's a failure, it throws a warning and returns an empty list.


Returns the name of the file.


Returns the basename (the last component the path) of the file.


Opens a filehandle for reading this file and returns it, or returns undef if the operation fails (the error is in $!). Instead of calling close $fh, $file->close should be called.


Resets the file back to the beginning. This is only called if may_be_present() is true, but not always if may_be_present() is true.


Close the file.


Clones this file.


Returns the first line of a file (or first 250 characters, whichever comes first).