CrcDotNET 1.0.3

.NET Standard 1.3 .NET Framework 3.5
Install-Package CrcDotNET -Version 1.0.3
dotnet add package CrcDotNET --version 1.0.3
<PackageReference Include="CrcDotNET" Version="1.0.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add CrcDotNET --version 1.0.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: CrcDotNET, 1.0.3"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install CrcDotNET as a Cake Addin
#addin nuget:?package=CrcDotNET&version=1.0.3

// Install CrcDotNET as a Cake Tool
#tool nuget:?package=CrcDotNET&version=1.0.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Crc.NET

.NET Standard library for calculating any CRC checksums

Motivation

I recently wrote a C++ library crc.h, this is more or less a direct C# port of it, since our codebase consists of both C++ and C# it was useful to have a native C# implementation of it.

Usage

The main class is CrcBase, it implements System.Security.Cryptography.HashAlgorithm. There are child classes for popular bit lengths: Crc8Base, Crc16Base, Crc32Base

Configurable parameters are:

  • Size The bit width of the CRC checksum
  • Polynomial A polynomial to use for CRC computation
  • InitialValue Initial value of the checksum
  • FinalXorValue Value to XOR the rsult with after finishing computation
  • ReflectInput Whether or not the input is reflected (bit order reversed)
  • ReflectOutput Whether or not the result is reflected (bit order reversed)
  • ExpectedCheck A checksum of an ASCII string "123456789". Used as a correctness check. Optional

By providing constructor parameters or deriving child classes, you can construct any CRC implementation. For example:

class Crc32 : Crc32Base
{
    public Crc32() : base(0x04C11DB7, 0xFFFFFFFF, 0xFFFFFFFF, true, true)
    {
    }
}

The usage is then quite simple:

Crc32 crc = new Crc32();
byte[] bytes = Encoding.ASCII.GetBytes("abc123");
byte[] resultBytes = crc.ComputeHash(bytes);
uint resultNum = BitConverter.ToUInt32(resultBytes, 0);

The library uses a 256-length lookup table to compute 8 bits of the checksum at the same time for performance reasons. For reflected input, the table is reflected instead. Although more optimizations could be made for specific implementations with concrete parameters, the main goal was generality and customizability. Due to the lookup table however, it should be quite fast. As always - benchmark first, optimize only as needed.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp1.0 netcoreapp1.1 netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard1.3 netstandard1.4 netstandard1.5 netstandard1.6 netstandard2.0 netstandard2.1
.NET Framework net35 net40 net403 net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen30 tizen40 tizen60
Universal Windows Platform uap uap10.0
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on CrcDotNET:

Package Downloads
RFPPF

RF-Networks Protocol Parser Framework

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.3 53,494 4/23/2019
1.0.2 1,208 6/22/2018
1.0.1 664 6/8/2018
1.0.0 644 6/7/2018