package Digest::base;
our ($VERSION);
$VERSION = "1.00";
# subclass is supposed to implement at least these
sub new { die "not implemented by subclass" }
sub clone { die "not implemented by subclass" }
sub add { die "not implemented by subclass" }
sub digest { die "not implemented by subclass" }
sub reset {
my $self = shift;
$self->new(< @_); # ugly
}
sub addfile($self, $handle) {
my $n;
my $buf = "";
while (($n = read($handle, $buf, 4*1024))) {
$self->add($buf);
}
unless (defined $n) {
require Carp;
Carp::croak("Read failed: $^OS_ERROR");
}
$self;
}
sub add_bits {
my $self = shift;
my $bits;
my $nbits;
if ((nelems @_) == 1) {
my $arg = shift;
$bits = pack("B*", $arg);
$nbits = length($arg);
}
else {
@($bits, $nbits) = @_;
}
if (($nbits % 8) != 0) {
require Carp;
Carp::croak("Number of bits must be multiple of 8 for this algorithm");
}
return $self->add(substr($bits, 0, $nbits/8));
}
sub hexdigest {
my $self = shift;
return unpack("H*", $self->digest(< @_));
}
sub b64digest {
my $self = shift;
require MIME::Base64;
my $b64 = MIME::Base64::encode($self->digest(< @_), "");
$b64 =~ s/=+$//;
return $b64;
}
1;
__END__
=head1 NAME
Digest::base - Digest base class
=head1 SYNOPSIS
package Digest::Foo;
use base 'Digest::base';
=head1 DESCRIPTION
The C<Digest::base> class provide implementations of the methods
C<addfile> and C<add_bits> in terms of C<add>, and of the methods
C<hexdigest> and C<b64digest> in terms of C<digest>.
Digest implementations might want to inherit from this class to get
this implementations of the alternative I<add> and I<digest> methods.
A minimal subclass needs to implement the following methods by itself:
new
clone
add
digest
The arguments and expected behaviour of these methods are described in
L<Digest>.
=head1 SEE ALSO
L<Digest>