The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Crypt::xxHash - xxHash implementation for Perl

SYNOPSIS

    use Crypt::xxHash qw/
            xxhash32 xxhash32_hex
            xxhash64 xxhash64_hex
            xxhash3_64bits xxhash3_64bits_hex
            xxhash3_128bits_hex /;

    my $hash = xxhash32( $data, $seed );
    my $hex  = xxhash32_hex( $data, $seed );

    my $hash_64 = xxhash64( $data, $seed );
    my $hex_64  = xxhash64_hex( $data, $seed );

    my $hash_64 = xxhash3_64bits( $data, $seed );
    my $hex_64  = xxhash3_64bits_hex( $data, $seed );

    my $hex_128 = xxhash3_128bits_hex( $data, $seed );

DESCRIPTION

xxHash is a super fast algorithm that claims to work at speeds close to RAM limits. This package provides 32- and 64-bit hash functions. As bonus it provides 128-bit hex method.

This package was inspired by Digest::xxHash, but it includes the fresh C code and has some optimisations. Thus all hex methods are implemented in Perl XS. Also this module doesn't use Math::Int64 in favor of native 64 bit digits.

The used version of xxHash is v0.8.0

$h = xxhash32( $data, $seed )

Returns a 32 bit hash.

$h = xxhash32_hex( $data, $seed )

Returns a 32 bit hash converted into hex string.

$h = xxhash64( $data, $seed )

Returns a 64 bit hash.

$h = xxhash64_hex( $data, $seed )

Returns a 64 bit hash converted into hex string

$h = xxhash3_64bits( $data, $seed )

Returns a 64 bit hash which calculated by using xxHash3 algorithm.

$h = xxhash3_64bits_hex( $data, $seed )

Returns a 64 bit hash which calculated by using xxHash3 algorithm. This hash is converted into hex string.

$h = xxhash3_128its_hex( $data, $seed )

Returns a 128 bit hash which calculated by using xxHash3 algorithm. This hash is converted into hex string.

SPEED

There are some official benchmark results can be found on the project web-site https://github.com/Cyan4973/xxHash

BENCHMARKS

Below you can find some benchmarks in comparison with Digest::xxHash.

The "xxhash32" methods in those two packages have the same realisation. so they have the same throughput capacity.

But other methods have some differences:

                                  Rate Digest::xxHash::xxhash32_hex Crypt::xxHash::xxhash32_hex
Digest::xxHash::xxhash32_hex 2577320/s                           --                        -54%
Crypt::xxHash::xxhash32_hex  5543237/s                         115%                          --

                               Rate Digest::xxHash::xxhash64 Crypt::xxHash::xxhash64
Digest::xxHash::xxhash64   201729/s                       --                    -99%
Crypt::xxHash::xxhash64  14893617/s                    7283%                      --

                                  Rate Digest::xxHash::xxhash64_hex Crypt::xxHash::xxhash64_hex
Digest::xxHash::xxhash64_hex  185048/s                           --                        -96%
Crypt::xxHash::xxhash64_hex  4926108/s                        2562%                          --

LICENSE

xxHash is covered by the BSD license.

AUTHOR

Chernenko Dmitiry cdn@cpan.org

xxHash by Yann Collet.