manpagez: man pages & more
man Crypt::Checksum::CRC32(3)
Home | html | info | man
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

       o   CryptX(3)

       o   <https://en.wikipedia.org/wiki/Cyclic_redundancy_check>



perl v5.30.3                      2022-01-07         Crypt::Checksum::CRC32(3)

cryptx 0.76.0 - Generated Mon Feb 14 06:15:01 CST 2022
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.