package com.carrotsearch.hppc;

/**
 * A set of Objects.
 */
 @javax.annotation.Generated(
    date = "2015-05-07T09:33:05+0200",
    value = "KTypeSet.java") 
public interface ObjectSet extends ObjectCollection {
  /**
   * Adds k to the set.
   * 
   * @return Returns true if this element was not part of the set
   *         before. Returns false if an equal element is part of
   *         the set, and replaces the existing equal element with the
   *         argument (if keys are object types).
   */
  public boolean add(KType k);

  /**
   * Visually depict the distribution of keys.
   * 
   * @param characters
   *          The number of characters to "squeeze" the entire buffer into.
   * @return Returns a sequence of characters where '.' depicts an empty
   *         fragment of the internal buffer and 'X' depicts full or nearly full
   *         capacity within the buffer's range and anything between 1 and 9 is between.
   */
  public String visualizeKeyDistribution(int characters);
}