Abstracts a file from the filesystem.
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
$file->close should be called.
Resets the file back to the beginning. This is only called if
needs_line_scan() is true, but not always if
needs_line_scan() is true.
Close the file.
Clones this file.
Returns the first line of a file (or first 250 characters, whichever comes first).