NAME

Meta::Ds::Map3 - a three way map.

COPYRIGHT

Copyright (C) 2001, 2002 Mark Veltzer; All rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.

DETAILS

        MANIFEST: Map3.pm
        PROJECT: meta
        VERSION: 0.01

SYNOPSIS

        package foo;
        use Meta::Ds::Map3 qw();
        my($object)=Meta::Ds::Map3->new();
        my($result)=$object->insert("1","014995815","Mark Veltzer");
        my($id)=$object->get_b_from_c("Mark Veltzer");
        # $id is now "014995815"

DESCRIPTION

This object allows you to store a three way map. Map between three values which each comes from a unique domain where each map entry connects three such values. For instance: lets say that each worked in a factory has a: 1. serial number. 2. social security number. 3. security id within the factory. Each of these is unique in it's domain. If you store all of your employee information in a 3 way map you could get an combination of the other 2 from any one piece of information quickly.

See the TEST() method to see it actually being used.

FUNCTIONS

        BEGIN()
        new($)
        insert($$$$)
        TEST($)

FUNCTION DOCUMENTATION

BEGIN()

Bootstrap method to provide access to the following attributes: 0. map_a_b - maps a to b elements. 1. map_a_c - maps a to c elements. 2. map_b_c - maps b to c elements.

new($)

This is a constructor for the Meta::Ds::Map3 object.

insert($$$$)

This is the insertion method. It receives the a,b and c elements.

TEST($)

This is a testing suite for the Meta::Ds::Map3 module. This test is should be run by a higher level management system at integration or release time or just as a regular routine to check that all is well.

Currently this test just creates an object and dumps it.

SUPER CLASSES

None.

BUGS

None.

AUTHOR

        Name: Mark Veltzer
        Email: mailto:veltzer@cpan.org
        WWW: http://www.veltzer.org
        CPAN id: VELTZER

HISTORY

        0.00 MV teachers project
        0.01 MV md5 issues

SEE ALSO

Meta::Class::MethodMaker(3), Meta::Ds::Map(3), Meta::Error::Simple(3), Meta::Utils::Output(3), strict(3)

TODO

Nothing.

cpanm Meta::Init

perl -MCPAN -e shell
install Meta::Init