FastHashes 3.0.0

FastHashes

FashHashes is a suite of .NET non-cryptographic hash functions.

<table> <tr> <td align="right">Status:</td> <td align="left"> <a href="https://github.com/TommasoBelluzzo/FastHashes/actions/workflows/continuous_integration.yml"><img alt="Build" src="https://img.shields.io/github/workflow/status/TommasoBelluzzo/FastHashes/Continuous%20Integration?style=flat&label=Build&color=1081C2"/></a> <a href="https://coveralls.io/github/TommasoBelluzzo/FastHashes?branch=master"><img alt="Coverage" src="https://img.shields.io/coveralls/github/TommasoBelluzzo/FastHashes?style=flat&label=Coverage&color=1081C2"/></a> </td> </tr> <tr> <td align="right">Info:</td> <td align="left"> <a href="#"><img alt="License" src="https://img.shields.io/github/license/TommasoBelluzzo/FastHashes?style=flat&label=License&color=1081C2"/></a> <a href="#"><img alt="Lines" src="https://img.shields.io/tokei/lines/github/TommasoBelluzzo/FastHashes?style=flat&label=Lines&color=1081C2"/></a> <a href="#"><img alt="Size" src="https://img.shields.io/github/repo-size/TommasoBelluzzo/FastHashes?style=flat&label=Size&color=1081C2"/></a> </td> </tr> <tr> <td align="right">NuGet:</td> <td align="left"> <a href="https://www.nuget.org/packages/FastHashes/"><img alt="Version" src="https://img.shields.io/nuget/v/FastHashes?style=flat&label=Version"/></a> <a href="https://www.nuget.org/packages/FastHashes/"><img alt="Downloads" src="https://img.shields.io/nuget/dt/FastHashes?style=flat&label=Downloads&color=1081C2"/></a> </td> </tr> <tr> <td align="right">Donation:</td> <td align="left"> <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=T8X35C2FED9SU"><img alt="PayPal" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif"/></a> </td> </tr> </table>

Main Features

• High Performing: deeply-optimized code makes extensive use of method inlining and unsafe memory pointers in order to speed up the computations.
• Allocation Free: all the internal functions follow a zero-allocation approach, only primitive types and/or arrays of primitive types are used by the algorithms.
• Endian-Agnostic: all the hashes provide consistent results regardless of the machine byte order, while only moderately affecting the overall performance of the computations.
• Platform-Agnostic: the code has been developed under .NET Standard framework and both x86 and x64 environments are fully supported.
• Fully Managed: since version 3.0.0, pointers requiring unsafe memory access contexts have been completely removed and the library is now fully managed.

Hashes

The library includes the following non-cryptographic hashes:

• FarmHash
  • 32/64/128 Bits Output
  • Fingerprint Versions
  • Reference Implementation: https://github.com/google/farmhash
• FastHash
  • 32/64 Bits Output
  • Reference Implementation: https://github.com/ZilongTan/fast-hash
• FastPositiveHash / TH1A
  • 64 Bits Output
  • 0/1/2 Variants
  • Reference Implementation: https://github.com/leo-yuriev/t1ha
• HalfSipHash
  • 32 Bits Output
  • Reference Implementation: https://github.com/veorq/SipHash
• HighwayHash
  • 64/128/256 Bits Output
  • Reference Implementation: https://github.com/google/highwayhash
• MetroHash
  • 64/128 Bits Output
  • 0/1 Variants
  • Reference Implementation: https://github.com/jandrewrogers/MetroHash
• MirHash
  • 64 Bits Output
  • Reference Implementation: https://github.com/vnmakarov/mir
• MumHash
  • 64 Bits Output
  • Reference Implementation: https://github.com/vnmakarov/mum-hash
• MurmurHash (v3)
  • 32/64/128 Bits Output
  • x86/x64 Variants
  • Reference Implementation: https://github.com/aappleby/smhasher
• PengyHash
  • 64 Bits Output
  • Strict Variant
  • Reference Implementation: https://github.com/tinypeng/pengyhash
• SipHash
  • 64 Bits Output
  • 1-3/2-4 Variants
  • Reference Implementation: https://github.com/veorq/SipHash
• SpookyHash
  • 32/64/128 Bits Output
  • Reference Implementation: http://burtleburtle.net/bob/hash/spooky.html
• xxHash
  • 32/64 Bits Output
  • Reference Implementation: https://github.com/Cyan4973/xxHash

Requirements

The following Frameworks are supported:

• Library: .NET Standard 2.0, .NET Standard 2.1
• Auxiliary Projects: .NET Core 2.1, .NET Core 3.1, .NET 5.0, .NET 6.0

The following NuGet packages are required for performing unit tests:

• Microsoft.NET.Test.Sdk
• xunit

Performance Benchmarks

The tests above have been conducted with the following machine setup:

• CPU: Intel Core i7-7700HQ @2.80GHz (4 Cores, 8 Threads, 256KB L1 Cache)
• RAM: 16 GB x DDR4 SO-DIMM @1200MHz
• OS: Microsoft Windows 10 64-Bit