NAME

FlatFile::DataStore::Lite::Record - Perl module that implements a lightweight flat file data store record class.

SYNOPSYS

# first, create a preamble object

use FlatFile::DataStore::Lite::Preamble;

my $preamble = FlatFile::DataStore::Lite::Preamble->new( {
    indicator => $indicator,  # single-character crud flag
    keynum    => $keynum,     # record sequence number (integer)
    reclen    => $reclen,     # record length (integer)
    thisfnum  => $fnum,       # file number (in base format)
    thisseek  => $datapos,    # seek position (integer)
    user      => $user_data,  # pre-formatted user-defined data
    } );

# then create a record object with the preamble contained in it

use FlatFile::DataStore::Lite::Record;

my $record = FlatFile::DataStore::Lite::Record->new( {
    preamble => $preamble,                 # i.e., a preamble object
    data     => "This is a test record.",  # actual record data
    } );

DESCRIPTION

FlatFile::DataStore::Lite::Record is a Perl module that implements a lightweight flat file data store record class. This class defines objects used by FlatFile::DataStore::Lite. You will likely not ever call new() yourself, (FlatFile::DataStore::Lite::create() would, e.g., do that) but you will likely call the accessors.

VERSION

FlatFile::DataStore::Lite::Record version 0.01

CLASS METHODS

FlatFile::DataStore::Lite::Record->new( $parms )

Constructs a new FlatFile::DataStore::Lite::Record object.

The parm $parms is a hash reference containing key/value pairs to populate the record string. Two keys are recognized:

- preamble, i.e., a FlatFile::DataStore::Lite::Preamble object
- data,     the actual record data

The record data is stored as a scalar reference.

OBJECT METHODS: ACCESSORS

The following read/write methods set and return their respective attribute values if $value is given. Otherwise, they just return the value.

$record->data(     [$value] ); # actual record data
$record->preamble( [$value] ); # FlatFile::DataStore::Lite::Preamble object

The following read-only methods just return their respective values. The values all come from the record's contained preamble object.

$record->user()
$record->string()
$record->indicator()
$record->keynum()
$record->reclen()
$record->thisfnum()
$record->thisseek()

AUTHOR

Brad Baxter, <bbaxter@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Brad Baxter

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.