NAME IO::Barf - Barfing content to output file. SYNOPSIS use IO::Barf qw(barf); barf($file_or_handler, 'CONTENT'); SUBROUTINES "barf($file_or_handler, $content)" Barf content to file or handler. ERRORS barf(): Cannot open file '%s'. Cannot close file '%s'. Unsupported reference '%s'. EXAMPLE1 # Pragmas. use strict; use warnings; # Module. use File::Temp; use IO::Barf; # Content. my $content = "foo\nbar\n"; # Temporary file. my $temp_file = File::Temp->new->filename; # Barf out. barf($temp_file, $content); # Print tempory file. system "cat $temp_file"; # Unlink temporary file. unlink $temp_file; # Output: # foo # bar EXAMPLE2 # Pragmas. use strict; use warnings; # Module. use IO::Barf; # Content. my $content = "foo\nbar\n"; # Barf out. barf(\*STDOUT, $content); # Output: # foo # bar EXAMPLE3 # Pragmas. use strict; use warnings; # Module. use Benchmark qw(cmpthese); use IO::Any; use IO::Barf; use File::Slurp qw(write_file); use File::Temp; # Temporary files. my $temp1 = File::Temp->new->filename; my $temp2 = File::Temp->new->filename; my $temp3 = File::Temp->new->filename; # Some data. my $data = 'x' x 1000; # Benchmark (10s). cmpthese(-10, { 'IO::Any' => sub { IO::Any->spew($temp2, $data); unlink $temp2; }, 'IO::Barf' => sub { barf($temp1, $data); unlink $temp1; }, 'File::Slurp' => sub { write_file($temp3, $data); unlink $temp3; }, }); # Output like this: # Rate IO::Any File::Slurp IO::Barf # IO::Any 6382/s -- -24% -48% # File::Slurp 8367/s 31% -- -32% # IO::Barf 12268/s 92% 47% -- DEPENDENCIES Error::Pure, Exporter, Readonly, Scalar::Util. SEE ALSO IO::Any, File::Slurp, Perl6::Slurp. REPOSITORY AUTHOR Michal Špaček LICENSE AND COPYRIGHT BSD license. VERSION 0.05