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).