Gapotchenko.FX.Data.Integrity.Checksum.Crc32 2024.1.3

Overview

The module provides the implementation of checksum algorithms belonging to the CRC-32 family.

Quick Start

Use the following code to calculate a CRC-32 checksum for the specified data, be it System.Byte[], System.ReadOnlySpan<Byte> or System.IO.Stream:

using Gapotchenko.FX.Data.Integrity.Checksum;

var checksum = Crc32.Standard.ComputeChecksum(data);

If you need to calculate a CRC-32 checksum iteratively then the following approach becomes handy:

var iterator = Crc32.Standard.CreateIterator();

iterator.ComputeBlock(...); // block 1
// ...
iterator.ComputeBlock(...); // block N

// Compute the final checksum:
var checksum = iterator.ComputeFinal();

Available CRC-32 Algorithms

CRC-32 family of cyclic redundancy checks consists of several attested checksum algorithms with predefined parameters:

The check parameter shows what checksum value an algorithm should produce for "123456789" input string interpreted as an ASCII data:

// Get the byte representation of the ASCII string.
var data = Encoding.ASCII.GetBytes("123456789");

// Compute the checksum.
var checksum = Crc32.Standard.ComputeChecksum(data);

// Print out the result ("Checksum=0xcbf43926" for standard CRC-32).
Console.WriteLine("Checksum=0x{0:x}", checksum);

Recommended CRC-32 Algorithms

Among all other possibilities, it is recommended to use the standard CRC-32 algorithm which comes under CRC-32, CRC-32/ISO-HDLC, CRC-32/ADCCP, CRC-32/V-42, CRC-32/XZ, PKZIP aliases and is available via Crc32.Standard property.

Another good option is CRC-32C algorithm which is widely used in data storage and communication industries, but more importantly, it benefits from a hardware acceleration provided by modern CPUs. The algorithm is available via Crc32.Attested.C property.

All other predefined algorithms are available via the corresponding properties of the Crc32.Attested class.

Custom CRC-32 Algorithms

Once in a while, you may encounter a custom CRC-32 algorithm that is neither widely known nor characterized. In that case, you can instantiate a custom checksum algorithm with the desired parameters by hand:

var checksumAlgorithm = new CustomCrc32(poly, init, refin, refout, xorout);

If you want to formalize the custom algorithm even further, you may opt in to create a separate class for it with a convenient accessor property:

/// <summary>
/// Defines a custom CRC-32 algorithm.
/// </summary>
sealed class FooCrc32 : CustomCrc32
{
    FooCrc32() :
        base(poly, init, refin, refout, xorout)
    {
    }

    public static FooCrc32 Instance { get; } = new();
}

That will allow you to use the algorithm effortlessly from several places in the codebase later:

var checksum = FooCrc32.Instance.ComputeChecksum(...);

Commonly Used Types

• Gapotchenko.FX.Data.Integrity.Checksum.Crc32

Other Modules

Let's continue with a look at some other modules provided by Gapotchenko.FX:

• Gapotchenko.FX
• Gapotchenko.FX.AppModel.Information
• Gapotchenko.FX.Collections
• Gapotchenko.FX.Console
• Gapotchenko.FX.Data
  • Gapotchenko.FX.Data.Encoding
  • Gapotchenko.FX.Data.Integrity.Checksum
    • Gapotchenko.FX.Data.Integrity.Checksum.Crc8
    • Gapotchenko.FX.Data.Integrity.Checksum.Crc16
    • ➴ Gapotchenko.FX.Data.Integrity.Checksum.Crc32
• Gapotchenko.FX.Diagnostics
• Gapotchenko.FX.IO
• Gapotchenko.FX.Linq
• Gapotchenko.FX.Math
• Gapotchenko.FX.Memory
• Gapotchenko.FX.Security.Cryptography
• Gapotchenko.FX.Text
• Gapotchenko.FX.Threading
• Gapotchenko.FX.Tuples

Or look at the full list of modules.