Gapotchenko.FX.Data.Integrity.Checksum 2026.4.2

Overview

The module provides a quasi-universal framework for cyclic redundancy checking algorithms. It supports both synchronous and asynchronous data processing including iterative checksum computation.

IChecksumAlgorithm<T>

Defines the root interface of a checksum algorithm. The generic parameter T specifies the data type of a checksum value. For example, System.UInt32 would be the type T for a CRC-32 algorithm.

The checksum algorithm interface provides several notable methods presented below.

ComputeChecksum(ReadOnlySpan<byte> data)

The method allows to compute a checksum value for the specified byte span. This is the most widely used operation. Example:

var data = new byte[] { ... };
var checksum = checksumAlgorithm.ComputeChecksum(data);
Console.WriteLine("The array checksum is {0}.", checksum);

ComputeChecksum(Stream stream)

The method computes the checksum for the specified System.IO.Stream object. This operation is useful for computing a checksum for a file or any other data stream in one go. Example:

using var file = File.OpenRead(...);
var checksum = checksumAlgorithm.ComputeChecksum(file);
Console.WriteLine("The file checksum is {0}.", checksum);

CreateIterator()

Sometimes the checksum computation cannot be performed in one go, and should be performed in chunks. That's why every checksum algorithm provides CreateIterator() method.

Once the iterator is created, it can be used for iterative checksum computation without data concatenation overhead:

var iterator = checksumAlgorithm.CreateIterator();

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

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

Console.WriteLine("The checksum is {0}.", checksum);

Checksum Algorithms

Gapotchenko.FX.Data.Integrity.Checksum module provides only the framework for checksum algorithm implementations. If you want to use a ready-to-use implementation, Gapotchenko.FX provides quite a few out of the box:

Moreover, you can create your own checksum algorithm implementations. Gapotchenko.FX project welcomes contributions, or it can be a standalone NuGet package that uses Gapotchenko.FX.Data.Integrity.Checksum module as a wireframe.

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.