/ 
Meta-0.07
River stage zero No dependents
/ Meta::Ds::Map3

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.00

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

SEE ALSO

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

TODO

Nothing.