Crypt::Checksum::CRC32

(source, CPAN)

version 0.084

NAME
SYNOPSIS
DESCRIPTION
EXPORT
FUNCTIONS
METHODS
- new
- clone
- reset
- add
- addfile
- digest
- hexdigest
- intdigest
SEE ALSO

#NAME

Crypt::Checksum::CRC32 - Compute CRC32 checksum

#SYNOPSIS

### Functional interface:
use Crypt::Checksum::CRC32 ':all';

# calculate CRC32 checksum from string/buffer
$checksum_raw  = crc32_data($data);
$checksum_hex  = crc32_data_hex($data);
$checksum_int  = crc32_data_int($data);
# calculate CRC32 checksum from file
$checksum_raw  = crc32_file('filename.dat');
$checksum_hex  = crc32_file_hex('filename.dat');
$checksum_int  = crc32_file_int('filename.dat');
# calculate CRC32 checksum from filehandle
$checksum_raw  = crc32_file(*FILEHANDLE);
$checksum_hex  = crc32_file_hex(*FILEHANDLE);
$checksum_int  = crc32_file_int(*FILEHANDLE);

### OO interface:
use Crypt::Checksum::CRC32;

$d = Crypt::Checksum::CRC32->new;
$d->add('any data');
$d->add('another data');
$d->addfile('filename.dat');
$d->addfile(*FILEHANDLE);
$checksum_raw = $d->digest;     # raw 4 bytes
$checksum_hex = $d->hexdigest;  # hexadecimal form
$checksum_int = $d->intdigest;  # 32bit unsigned integer

#DESCRIPTION

Calculating CRC32 checksums.

Updated: v0.057

#EXPORT

Nothing is exported by default.

You can export selected functions:

use Crypt::Checksum::CRC32 qw(crc32_data crc32_data_hex crc32_data_int crc32_file crc32_file_hex crc32_file_int);

Or all of them at once:

use Crypt::Checksum::CRC32 ':all';

#FUNCTIONS

#crc32_data

Returns checksum as raw octects.

$checksum_raw = crc32_data('data string');
#or
$checksum_raw = crc32_data('any data', 'more data', 'even more data');

#crc32_data_hex

Returns checksum as a hexadecimal string.

$checksum_hex = crc32_data_hex('data string');
#or
$checksum_hex = crc32_data_hex('any data', 'more data', 'even more data');

#crc32_data_int

Returns checksum as unsigned 32bit integer.

$checksum_int = crc32_data_int('data string');
#or
$checksum_int = crc32_data_int('any data', 'more data', 'even more data');

#crc32_file

Returns checksum as raw octects.

$checksum_raw = crc32_file('filename.dat');
#or
$checksum_raw = crc32_file(*FILEHANDLE);

#crc32_file_hex

Returns checksum as a hexadecimal string.

$checksum_hex = crc32_file_hex('filename.dat');
#or
$checksum_hex = crc32_file_hex(*FILEHANDLE);

#crc32_file_int

Returns checksum as unsigned 32bit integer.

$checksum_int = crc32_file_int('filename.dat');
#or
$checksum_int = crc32_file_int(*FILEHANDLE);

#METHODS

#new

Constructor, returns a reference to the checksum object.

$d = Crypt::Checksum::CRC32->new;

#clone

Creates a copy of the checksum object state and returns a reference to the copy.

$d->clone();

#reset

Reinitialize the checksum object state and returns a reference to the checksum object.

$d->reset();

#add

All arguments are appended to the message we calculate checksum for. The return value is the checksum object itself.

$d->add('any data');
#or
$d->add('any data', 'more data', 'even more data');

#addfile

The content of the file (or filehandle) is appended to the message we calculate checksum for. The return value is the checksum object itself.

$d->addfile('filename.dat');
#or
$d->addfile(*FILEHANDLE);

BEWARE: You have to make sure that the filehandle is in binary mode before you pass it as argument to the addfile() method.

#digest

Returns the binary checksum (raw bytes).

$result_raw = $d->digest();

#hexdigest

Returns the checksum encoded as a hexadecimal string.

$result_hex = $d->hexdigest();

#intdigest

Returns the checksum encoded as unsigned 32bit integer.

$result_int = $d->intdigest();

CONTENTS