PrimitiveSink that can compute a hash code after reading the input. Each hasher should
translate all multibyte values (putInt(int), putLong(long), etc) to bytes in
little-endian order.Warning
The result of calling any methods after calling hash is undefined.
Warning
Using a specific character encoding when hashing a CharSequence with
putString(CharSequence, Charset) is generally only useful for cross-language
compatibility (otherwise prefer putUnencodedChars). However, the character encodings
must be identical across languages. Also beware that Charset definitions may occasionally
change between Java releases.
Warning
Chunks of data that are put into the Hasher are not delimited. The
resulting HashCode is dependent only on the bytes inserted, and the order in which they
were inserted, not how those bytes were chunked into discrete put() operations. For example, the
following three expressions all generate colliding hash codes:
newHasher().putByte(b1).putByte(b2).putByte(b3).hash()
newHasher().putByte(b1).putBytes(new byte[] { b2, b3 }).hash()
newHasher().putBytes(new byte[] { b1, b2, b3 }).hash()
If you wish to avoid this, you should either prepend or append the size of each chunk. Keep in
mind that when dealing with char sequences, the encoded form of two concatenated char sequences
is not equivalent to the concatenation of their encoded form. Therefore, putString(CharSequence, Charset) should only be used consistently with complete
sequences and not broken into chunks.
| Modifier and Type | Method and Description |
|---|---|
| public HashCode | |
| public int | hashCode()
Deprecated
This returns
Object#hashCode(); you almost certainly mean to call hash().asInt().
|
| public Hasher | putBoolean(boolean b)
Redeclares com. putByte(b ?
|
| public Hasher | putByte(byte
a byte b)Redeclares com. |
| public Hasher | putBytes(byte[]
a byte array bytes)Redeclares com. |
| public Hasher | putBytes(byte[]
a byte array bytes, int the start offset in the array off, int the number of bytes to write len)Redeclares com. |
| public Hasher | putBytes(ByteBuffer
a byte buffer bytes)Redeclares com. |
| public Hasher | putChar(char c)
Redeclares com. |
| public Hasher | putDouble(double d)
Redeclares com. putLong(Double.doubleToRawLongBits(d)).
|
| public Hasher | putFloat(float f)
Redeclares com. putInt(Float.floatToRawIntBits(f)).
|
| public Hasher | |
| public Hasher | |
| public <T extends @Nullable Object> Hasher | |
| public Hasher | putShort(short s)
Redeclares com. |
| public Hasher | putString(CharSequence charSequence, Charset charset)
Redeclares com. putBytes(charSequence.toString().getBytes(charset)).
|
| public Hasher | putUnencodedChars(CharSequence charSequence)
Redeclares com. char value in the CharSequence, in order.
|
| hash | back to summary |
|---|---|
| public HashCode hash() Computes a hash code based on the data that have been provided to this hasher. The result is unspecified if this method is called more than once on the same instance. | |
| hashCode | back to summary |
|---|---|
| public int hashCode()
Deprecated This returns
| |
| putBoolean | back to summary |
|---|---|
| public Hasher putBoolean(boolean b) Redeclares com. Equivalent to
| |
| putByte | back to summary |
|---|---|
| public Hasher putByte(byte b) Redeclares com. Doc from com. Puts a byte into this sink.
| |
| putBytes | back to summary |
|---|---|
| public Hasher putBytes(byte[] bytes) Redeclares com. Doc from com. Puts an array of bytes into this sink.
| |
| putBytes | back to summary |
|---|---|
| public Hasher putBytes(byte[] bytes, int off, int len) Redeclares com. Doc from com. Puts a chunk of an array of bytes into this sink.
| |
| putBytes | back to summary |
|---|---|
| public Hasher putBytes(ByteBuffer bytes) Redeclares com. Doc from com. Puts the remaining bytes of a byte buffer into this sink.
| |
| putChar | back to summary |
|---|---|
| public Hasher putChar(char c) Redeclares com. Doc from com. Puts a character into this sink.
| |
| putDouble | back to summary |
|---|---|
| public Hasher putDouble(double d) Redeclares com. Equivalent to
| |
| putFloat | back to summary |
|---|---|
| public Hasher putFloat(float f) Redeclares com. Equivalent to
| |
| putInt | back to summary |
|---|---|
| public Hasher putInt(int i) Redeclares com. Doc from com. Puts an int into this sink.
| |
| putLong | back to summary |
|---|---|
| public Hasher putLong(long l) Redeclares com. Doc from com. Puts a long into this sink.
| |
| putObject | back to summary |
|---|---|
| public <T extends @Nullable Object> Hasher putObject(T instance, Funnel<? super T> funnel) A simple convenience for
| |
| putShort | back to summary |
|---|---|
| public Hasher putShort(short s) Redeclares com. Doc from com. Puts a short into this sink.
| |
| putString | back to summary |
|---|---|
| public Hasher putString(CharSequence charSequence, Charset charset) Redeclares com. Equivalent to Warning This method, which reencodes the input before hashing it, is useful only for
cross-language compatibility. For other use cases, prefer
| |
| putUnencodedChars | back to summary |
|---|---|
| public Hasher putUnencodedChars(CharSequence charSequence) Redeclares com. Equivalent to processing each Warning This method will produce different output than most other languages do when
running the same hash function on the equivalent input. For cross-language compatibility, use
| |