File::Data 1.12

File::Data is a Perl module as a interface to file data.

Wraps all the accessing of a file into a convenient set of calls for reading and writing data, including a simple regex interface.

Note that the file needs to exist prior to using this module!

See new()

SYNOPSIS

use strict;

use File::Data;

my $o_dat = File::Data->new(./t/example);

$o_dat->write("complete file contentsn");

$o_dat->prepend("first linen"); # line 0

$o_dat->append("original second (last) linen");

$o_dat->insert(2, "new second linen"); # inc. zero!

$o_dat->replace(line, LINE);

print $o_dat->READ;

Or, perhaps more seriously :-}

my $o_sgm = File::Data->new(./sgmlfile);

print "new SGML data: ".$o_sgm->REPLACE(
s*((?s).*)s* ,
qq| key="val" |,
) if $o_sgm;

See METHODS and EXAMPLES.

IMPORTANT

lowercase method calls return the object itself, so you can chain calls.

my $o_obj = $o_dat->read; # ! <= object !

UPPERCASE method calls return the data relevant to the operation.

my @data = $o_dat->READ; # ! <= data !

While this may occasionally be frustrating, using the principle of least surprise, it is at least consistent.