README.md

Documentation: github.com/zeebo/xxh3

     1# XXH3
     2[![GoDoc](https://godoc.org/github.com/zeebo/xxh3?status.svg)](https://godoc.org/github.com/zeebo/xxh3)
     3[![Sourcegraph](https://sourcegraph.com/github.com/zeebo/xxh3/-/badge.svg)](https://sourcegraph.com/github.com/zeebo/xxh3?badge)
     4[![Go Report Card](https://goreportcard.com/badge/github.com/zeebo/xxh3)](https://goreportcard.com/report/github.com/zeebo/xxh3)
     5
     6This package is a port of the [xxh3](https://github.com/Cyan4973/xxHash) library to Go.
     7
     8Upstream has fixed the output as of v0.8.0, and this package matches that.
     9
    10---
    11
    12# Benchmarks
    13
    14Run on my `i7-8850H CPU @ 2.60GHz`
    15
    16## Small Sizes
    17
    18| Bytes     | Rate                                 |
    19|-----------|--------------------------------------|
    20|` 0 `      |` 0.74 ns/op `                       |
    21|` 1-3 `    |` 4.19 ns/op (0.24 GB/s - 0.71 GB/s) `|
    22|` 4-8 `    |` 4.16 ns/op (0.97 GB/s - 1.98 GB/s) `|
    23|` 9-16 `   |` 4.46 ns/op (2.02 GB/s - 3.58 GB/s) `|
    24|` 17-32 `  |` 6.22 ns/op (2.76 GB/s - 5.15 GB/s) `|
    25|` 33-64 `  |` 8.00 ns/op (4.13 GB/s - 8.13 GB/s) `|
    26|` 65-96 `  |` 11.0 ns/op (5.91 GB/s - 8.84 GB/s) `|
    27|` 97-128 ` |` 12.8 ns/op (7.68 GB/s - 10.0 GB/s) `|
    28
    29## Large Sizes
    30
    31| Bytes   | Rate                     | SSE2 Rate                | AVX2 Rate                |
    32|---------|--------------------------|--------------------------|--------------------------|
    33|` 129 `  |` 13.6 ns/op (9.45 GB/s) `|                          |                          |
    34|` 240 `  |` 23.8 ns/op (10.1 GB/s) `|                          |                          |
    35|` 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) `|
    36|` 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) `|
    37|` 1024 ` |` 132  ns/op (7.77 GB/s) `|` 48.9 ns/op (20.9 GB/s) `|` 37.7 ns/op (27.2 GB/s) `|
    38|` 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) `|
View as plain text