Initial commit

9781565926998

 No newline at end of file

## Example files for the title:  

# Programming the Perl DBI, by Tim Bunce

[![Programming the Perl DBI, by Tim Bunce](http://akamaicovers.oreilly.com/images/9781565926998/cat.gif)](https://www.safaribooksonline.com/library/view/title/1565926994//)

The following applies to example files from material published by O’Reilly Media, Inc. Content from other publishers may include different rules of usage. Please refer to any additional usage rights explained in the actual example files or refer to the publisher’s website.

O'Reilly books are here to help you get your job done. In general, you may use the code in O'Reilly books in your programs and documentation. You do not need to contact us for permission unless you're reproducing a significant portion of the code. For example, writing a program that uses several chunks of code from our books does not require permission. Answering a question by citing our books and quoting example code does not require permission. On the other hand, selling or distributing a CD-ROM of examples from O'Reilly books does require permission. Incorporating a significant amount of example code from our books into your product's documentation does require permission.

We appreciate, but do not require, attribution. An attribution usually includes the title, author, publisher, and ISBN.

If you think your use of code examples falls outside fair use or the permission given here, feel free to contact us at <permissions@oreilly.com>.

Please note that the examples are not production code and have not been carefully testing. They are provided "as-is" and come with no warranty of any kind.

#!/usr/bin/perl -w

#

# ch02/DBM/Megalith.pm: A perl class encapsulating a megalith

package Megalith;

use strict;

use Carp;

### Creates a new megalith object and initializes the member fields.

sub new {

    my $class = shift;

    my ( $name, $location, $mapref, $type, $description ) = @_;

    my $self = {};

    bless $self => $class;

    ### If we only have one argument, assume we have a string

    ### containing all the field values in $name and unpack it

    if ( @_ == 1 ) {

        $self->unpack( $name );

    }

    else {

        $self->{name} = $name;

        $self->{location} = $location;

        $self->{mapref} = $mapref;

        $self->{type} = $type;

        $self->{description} = $description;

    }

    return $self;

}

### Packs the current field values into a colon delimited record

### and returns it

sub pack {

    my ( $self ) = @_;

    my $record = join( ':', $self->{name}, $self->{location},

                            $self->{mapref}, $self->{type},

                            $self->{description} );

    ### Simple check that fields don't contain any colons

    croak "Record field contains ':' delimiter character"

        if $record =~ tr/:/:/ != 4;

    return $record;

}

### Unpacks the given string into the member fields

sub unpack {

    my ( $self, $packedString ) = @_;

    ### Naive split...Assumes no inter-field delimiters

    my ( $name, $location, $mapref, $type, $description ) =

        split( ':', $packedString, 5 );

    $self->{name} = $name;

    $self->{location} = $location;

    $self->{mapref} = $mapref;

    $self->{type} = $type;

    $self->{description} = $description;

}

### Displays the megalith data

sub dump {

    my ( $self ) = @_;

    print "$self->{name} ( $self->{type} )\n", 

          "=" x ( length( $self->{name} ) + 

                  length( $self->{type} ) + 5 ), "\n";

    print "Location:      $self->{location}\n"; 

    print "Map Reference: $self->{mapref}\n";

    print "Description:   $self->{description}\n\n";

}

1;