NAME
App::Ack::File
DESCRIPTION
Abstracts a file from the filesystem.
METHODS
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.
$file->name()
Returns the name of the file.
$file->basename()
Returns the basename (the last component the path) of the file.
$file->open()
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.
$file->reset()
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.
$file->close()
Close the file.
$file->clone()
Clones this file.
$file->firstliney()
Returns the first line of a file (or first 250 characters, whichever comes first).