View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Christian Lackas > Digest-Perl-MD5-1.8 > Digest::MD5::Perl


Annotate this POD


New  2
Open  0
View/Report Bugs
Source   Latest Release: Digest-Perl-MD5-1.9


Digest::MD5::Perl - Perl implementation of Ron Rivests MD5 Algorithm


This is not an interface (like Digest::MD5) but a Perl implementation of MD5. It is written in perl only and because of this it is slow but it works without C-Code. You should use Digest::MD5 instead of this module if it is available. This module is only usefull for


 # Functional style
 use Digest::MD5  qw(md5 md5_hex md5_base64);

 $hash = md5 $data;
 $hash = md5_hex $data;
 $hash = md5_base64 $data;

 # OO style
 use Digest::MD5;

 $ctx = Digest::MD5->new;


 $digest = $ctx->digest;
 $digest = $ctx->hexdigest;
 $digest = $ctx->b64digest;


This modules has the same interface as the much faster Digest::MD5. So you can easily exchange them, e.g.

        BEGIN {
          eval {
            require Digest::MD5;
            import Digest::MD5 'md5_hex'
          if ($@) { # ups, no Digest::MD5
            require Digest::Perl::MD5;
            import Digest::Perl::MD5 'md5_hex'

If the Digest::MD5 module is available it is used and if not you take Digest::Perl::MD5.

You can also install the Perl part of Digest::MD5 together with Digest::Perl::MD5 and use Digest::MD5 as normal, it falls back to Digest::Perl::MD5 if it cannot load its object files.

For a detailed Documentation see the Digest::MD5 module.


The simplest way to use this library is to import the md5_hex() function (or one of its cousins):

    use Digest::Perl::MD5 'md5_hex';
    print 'Digest is ', md5_hex('foobarbaz'), "\n";

The above example would print out the message

    Digest is 6df23dc03f9b54cc38a0fc1483df6e21

provided that the implementation is working correctly. The same checksum can also be calculated in OO style:

    use Digest::MD5;
    $md5 = Digest::MD5->new;
    $md5->add('foo', 'bar');
    $digest = $md5->hexdigest;
    print "Digest is $digest\n";

The digest methods are destructive. That means you can only call them once and the $md5 objects is reset after use. You can make a copy with clone:



This implementation of the MD5 algorithm has some limitations:




RFC 1321

tools/md5: a small BSD compatible md5 tool written in pure perl.


This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

 Copyright 2000 Christian Lackas, Imperia Software Solutions
 Copyright 1998-1999 Gisle Aas.
 Copyright 1995-1996 Neil Winton.
 Copyright 1991-1992 RSA Data Security, Inc.

The MD5 algorithm is defined in RFC 1321. The basic C code implementing the algorithm is derived from that in the RFC and is covered by the following copyright:

This copyright does not prohibit distribution of any version of Perl containing this extension under the terms of the GNU or Artistic licenses.


The original MD5 interface was written by Neil Winton (<N.Winton (at)>).

Digest::MD5 was made by Gisle Aas <gisle (at)> (I took his Interface and part of the documentation).

Thanks to Guido Flohr for his 'use integer'-hint.

This release was made by Christian Lackas <delta (at)>.

syntax highlighting: