CrcDotNET 1.0.1
See the version list below for details.
Install-Package CrcDotNET -Version 1.0.1
dotnet add package CrcDotNET --version 1.0.1
<PackageReference Include="CrcDotNET" Version="1.0.1" />
paket add CrcDotNET --version 1.0.1
#r "nuget: CrcDotNET, 1.0.1"
// Install CrcDotNET as a Cake Addin
#addin nuget:?package=CrcDotNET&version=1.0.1
// Install CrcDotNET as a Cake Tool
#tool nuget:?package=CrcDotNET&version=1.0.1
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 checksumPolynomial
A polynomial to use for CRC computationInitialValue
Initial value of the checksumFinalXorValue
Value to XOR the rsult with after finishing computationReflectInput
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 | 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 |
-
.NETStandard 1.3
- NETStandard.Library (>= 1.6.1)
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.