Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Copyright (C) 2011 The Guava Authors
   *
   * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
   * in compliance with the License. You may obtain a copy of the License at
   *
   * http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software distributed under the License
  * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
 
 package com.google.common.hash;
 
 
A 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 java.lang.CharSequence with putString(java.lang.CharSequence,java.nio.charset.Charset) is generally only useful for cross-language compatibility (otherwise prefer putUnencodedChars(java.lang.CharSequence)). However, the character encodings must be identical across languages. Also beware that java.nio.charset.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(java.lang.CharSequence,java.nio.charset.Charset) should only be used consistently with complete sequences and not broken into chunks.

Author(s):
Kevin Bourrillion
Since:
11.0
 
 public interface Hasher extends PrimitiveSink {
   @Override Hasher putByte(byte b);
   @Override Hasher putBytes(byte[] bytes);
   @Override Hasher putBytes(byte[] bytesint offint len);
   @Override Hasher putShort(short s);
   @Override Hasher putInt(int i);
   @Override Hasher putLong(long l);

  
Equivalent to putInt(Float.floatToRawIntBits(f)).
 
   @Override Hasher putFloat(float f);

  
Equivalent to putLong(Double.doubleToRawLongBits(d)).
 
   @Override Hasher putDouble(double d);

  
Equivalent to putByte(b ? (byte) 1 : (byte) 0).
 
   @Override Hasher putBoolean(boolean b);
   @Override Hasher putChar(char c);

  
Equivalent to processing each char value in the CharSequence, in order. The input must not be updated while this method is in progress.

Since:
15.0 (since 11.0 as putString(CharSequence)).
 
   @Override Hasher putUnencodedChars(CharSequence charSequence);

  
Equivalent to processing each char value in the CharSequence, in order. The input must not be updated while this method is in progress.

Deprecated:
Use putUnencodedChars(java.lang.CharSequence) instead. This method is scheduled for removal in Guava 16.0.
 
   @Override Hasher putString(CharSequence charSequence);

  
Equivalent to putBytes(charSequence.toString().getBytes(charset)).
 
   @Override Hasher putString(CharSequence charSequenceCharset charset);

  
A simple convenience for funnel.funnel(object, this).
  <T> Hasher putObject(T instanceFunnel<? super T> funnel);

  
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.
New to GrepCode? Check out our FAQ X