#!/usr/bin/perl

# $Id: Member.pm,v 1.5 2003/06/06 18:45:02 unimlo Exp $

package Net::ACL::Match::Member;

use strict;
use vars qw( $VERSION @ISA );

## Inheritance and Versioning ##

@ISA     = qw( Net::ACL::Match::Scalar );
$VERSION = '0.07';

## Module Imports ##

use Net::ACL::Match::Scalar;
use Net::ACL::Rule qw( :rc );
use Carp;

## Public Object Methods ##

sub match
{
 my $this = shift;
 my @data = @_;
 my $data = $data[$this->{_index}];
 croak __PACKAGE__ . "->match needs to operate on an array reference!"
        unless ref $data eq 'ARRAY';
 my %miss;
 foreach my $elem ( @{$this->{_value}} )
  {
   $miss{$elem} = 1;
  };
 foreach my $elem ( @{$data} )
  {
   delete $miss{$elem};
  };
 return scalar (keys %miss) ? ACL_NOMATCH : ACL_MATCH;
}

## POD ##

=pod

=head1 NAME

Net::ACL::Match::Member - Class matching one or more members of an array

=head1 SYNOPSIS

    use Net::ACL::Match::Member;

    # Construction
    my $match = new Net::ACL::Match::Member(1,[41,42]);

    # Accessor Methods
    $rc = $match->match(@data);

=head1 DESCRIPTION

This module is a very simple array element testing utility to allow
simple value matching with L<Net::ACL::Rule|Net::ACL::Rule>.

=head1 CONSTRUCTOR

=over 4

=item new() - create a new Net::ACL::Match::Member object 

    my $match = new Net::ACL::Match::Member(1,[41,42]);

This is the constructor for Net::ACL::Match::Scalar objects.
It returns a reference to the newly created object.

It takes one argument. If the argument is a array reference with one element,
the element will be matched with the first argument to the match method.

If an array reference has more then one element, the second element should be
the argument number to be matched in the match method.

Otherwise, the value it self will be matched with the first argument of
the match method.

=back

=head1 ACCESSOR METHODS

=over 4

=item match()

This function matches the arguments according to the arguments of the
constructor and returns either C<ACL_MATCH> or C<ACL_NOMATCH> as exported by
Net::ACL::Rule with C<:rc>.

=back

=head1 SEE ALSO

Net::ACL::Match, Net::ACL::Rule, Net::ACL, Net::ACL::Set::Union

=head1 AUTHOR

Martin Lorensen <bgp@martin.lorensen.dk>

=cut

## End Package Net::ACL::Match::Member ##
 
1;