NAME¶
File::Slurp::Tiny - A simple, sane and efficient file slurper
VERSION¶
version 0.003
SYNOPSIS¶
use File::Slurp::Tiny 'read_file';
my $content = read_file($filename);
DESCRIPTION¶
This module provides functions for fast and correct slurping and spewing. All
functions are optionally exported.
FUNCTIONS¶
read_file($filename, %options)¶
Reads file $filename into a scalar. By default it returns this scalar. Can
optionally take these named arguments:
- •
- binmode
Set the layers to read the file with. The default will be something sensible
on your platform.
- •
- buf_ref
Pass a reference to a scalar to read the file into, instead of returning it
by value. This has performance benefits.
- •
- scalar_ref
If set to true, "read_file" will return a reference to a scalar
containing the file content.
read_lines($filename, %options)¶
Reads file $filename into a list/array. By default it returns this list. Can
optionally take these named arguments:
- •
- binmode
Set the layers to read the file with. The default will be something sensible
on your platform.
- •
- array_ref
Pass a reference to an array to read the lines into, instead of returning
them by value. This has performance benefits.
- •
- chomp
"chomp" the lines.
write_file($filename, $content, %options)¶
Open $filename, and write $content to it. Can optionally take this named
argument:
- •
- binmode
Set the layers to write the file with. The default will be something
sensible on your platform.
read_dir($dirname, %options)¶
Open "dirname" and return all entries except "." and
"..". Can optionally take this named argument:
- •
- prefix
This will prepend $dir to the entries
SEE ALSO¶
- •
- Path::Tiny
A minimalistic abstraction not only around
- •
- File::Slurp
Another file slurping tool.
AUTHOR¶
Leon Timmermans <leont@cpan.org>
COPYRIGHT AND LICENSE¶
This software is copyright (c) 2013 by Leon Timmermans.
This is free software; you can redistribute it and/or modify it under the same
terms as the Perl 5 programming language system itself.