mirror of
https://github.com/syncthing/syncthing.git
synced 2024-11-17 02:48:57 -07:00
c24bf7ea55
GitHub-Pull-Request: https://github.com/syncthing/syncthing/pull/4620
49 lines
1.4 KiB
Go
49 lines
1.4 KiB
Go
/*
|
|
|
|
Package rollinghash implements rolling versions of some hashes
|
|
|
|
*/
|
|
package rollinghash
|
|
|
|
import "hash"
|
|
|
|
// DefaultWindowCap is the default capacity of the internal window of a
|
|
// new Hash.
|
|
const DefaultWindowCap = 64
|
|
|
|
// A Roller is a type that has the method Roll. Roll updates the hash of a
|
|
// rolling window from just the entering byte. You MUST call Write()
|
|
// BEFORE using this method and provide it with an initial window of size
|
|
// at least 1 byte. You can then call this method for every new byte
|
|
// entering the window. The byte leaving the window is automatically
|
|
// computed from a copy of the window internally kept in the checksum.
|
|
// This window is updated along with the internal state of the checksum
|
|
// every time Roll() is called.
|
|
type Roller interface {
|
|
Roll(b byte)
|
|
}
|
|
|
|
// rollinghash.Hash extends hash.Hash by adding the method Roll. A
|
|
// rollinghash.Hash can be updated byte by byte, by specifying which byte
|
|
// enters the window.
|
|
type Hash interface {
|
|
hash.Hash
|
|
Roller
|
|
}
|
|
|
|
// rollinghash.Hash32 extends hash.Hash by adding the method Roll. A
|
|
// rollinghash.Hash32 can be updated byte by byte, by specifying which
|
|
// byte enters the window.
|
|
type Hash32 interface {
|
|
hash.Hash32
|
|
Roller
|
|
}
|
|
|
|
// rollinghash.Hash64 extends hash.Hash by adding the method Roll. A
|
|
// rollinghash.Hash64 can be updated byte by byte, by specifying which
|
|
// byte enters the window.
|
|
type Hash64 interface {
|
|
hash.Hash64
|
|
Roller
|
|
}
|