👁 Image
Gapotchenko.FX.Data.Integrity.Checksum.Crc32 2026.7.2

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 a byte representation of the string.
var data = Encoding.ASCII.GetBytes("123456789");

// Compute a CRC-32 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 implementation even further, you may opt into creating a separate class 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.Archives
  • 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
• Gapotchenko.FX.Versioning

Or look at the full list of modules.