Crypt::Checksum::CRC32(3) | User Contributed Perl Documentation | Crypt::Checksum::CRC32(3) |
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();
SEE ALSO¶
2024-03-08 | perl v5.40.0 |