File::Slurp::Tiny(3) User Contributed Perl Documentation File::Slurp::Tiny(3)NAMEFile::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.
perl v5.18.2 2014-01-20 File::Slurp::Tiny(3)