xxh3

README

XXH3

This package is a port of the xxh3 library to Go.

Upstream has fixed the output as of v0.8.0, and this package matches that.

---

Benchmarks

Run on my i7-8850H CPU @ 2.60GHz

Small Sizes

Bytes	Rate
0	0.74 ns/op
1-3	4.19 ns/op (0.24 GB/s - 0.71 GB/s)
4-8	4.16 ns/op (0.97 GB/s - 1.98 GB/s)
9-16	4.46 ns/op (2.02 GB/s - 3.58 GB/s)
17-32	6.22 ns/op (2.76 GB/s - 5.15 GB/s)
33-64	8.00 ns/op (4.13 GB/s - 8.13 GB/s)
65-96	11.0 ns/op (5.91 GB/s - 8.84 GB/s)
97-128	12.8 ns/op (7.68 GB/s - 10.0 GB/s)

Large Sizes

Bytes	Rate	SSE2 Rate	AVX2 Rate
129	13.6 ns/op (9.45 GB/s)
240	23.8 ns/op (10.1 GB/s)
241	40.5 ns/op (5.97 GB/s)	23.3 ns/op (10.4 GB/s)	20.1 ns/op (12.0 GB/s)
512	69.8 ns/op (7.34 GB/s)	30.4 ns/op (16.9 GB/s)	24.7 ns/op (20.7 GB/s)
1024	132 ns/op (7.77 GB/s)	48.9 ns/op (20.9 GB/s)	37.7 ns/op (27.2 GB/s)
100KB	13.0 us/op (7.88 GB/s)	4.05 us/op (25.3 GB/s)	2.31 us/op (44.3 GB/s)

Documentation

Index

• func Hash(b []byte) uint64
• func HashString(s string) uint64
• type Uint128
  • func Hash128(b []byte) Uint128
  • func HashString128(s string) Uint128

Functions

func Hash

func Hash(b []byte) uint64

Hash returns the hash of the byte slice.

func HashString

func HashString(s string) uint64

Hash returns the hash of the string slice.

Types

type Uint128

type Uint128 struct {
	Hi uint64
	Lo uint64
}

Uint128 is a 128 bit value. The actual value can be thought of as u.Hi<<64 | u.Lo.

func Hash128

func Hash128(b []byte) Uint128

Hash128 returns the 128-bit hash of the byte slice.

func HashString128

func HashString128(s string) Uint128

HashString128 returns the 128-bit hash of the string slice.