/ 
File-Slurp-Chomp-0.02
/ File::Slurp::Chomp

NAME

File::Slurp::Chomp - Add autochomping capability to File::Slurp

VERSION

version 0.02

SYNOPSIS

Instead of:

use File::Slurp qw(slurp ...);

use:

use File::Slurp::Chomp qw(slurp ...);

and in addition to File::Slurp's features, you can also:

my $scalar = read_file('path', chomp=>1);
my @array  = slurp    ('path', chomp=>1);

You can also import read_file_cq or slurp_cq (short for "chomp & quiet") as a shortcut for:

read_file('path', chomp=>1, err_mode=>'quiet', ...);

DESCRIPTION

Autochomping is supposed to be in the upcoming version of File::Slurp, but I'm tired of waiting so this module is a band-aid solution. It wraps read_file() (and slurp()) so it handles the chomp option.

This module also offers read_file_cq (or slurp_cq), so if you like me often write this:

my $var   = read_file('/some/config/var', err_mode=>'quiet');
chomp($var) if defined($var);

my @lines = read_file('/some/config/file', err_mode=>'quiet');
chomp for @lines;

you can now write this:

my $var   = slurp_cq('/some/config/var');
my @lines = slurp_cq('/some/config/file');

FUNCTIONS

For the list of functions available, see File::Slurp. Below are functions introduced by File::Slurp::Chomp:

read_file_c($path, %opts)

Shortcut for:

read_file('path', chomp=>1, ...)

Alias: slurp_c

read_file_cq($path, %opts)

Shortcut for:

read_file('path', chomp=>1, err_mode=>'quiet', ...)

Alias: slurp_cq

read_file_q($path, %opts)

Shortcut for:

read_file('path', err_mode=>'quiet', ...)

Alias: slurp_q

SEE ALSO

File::Slurp, obviously.

AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Steven Haryanto.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.