com.carrotsearch.hppcrt.ObjectLongAssociativeContainer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of hppcrt Show documentation

High Performance Primitive Collections Realtime (fork of HPPC from Carrotsearch) Fundamental data structures (maps, sets, lists, queues, heaps, sorts) generated for combinations of object and primitive types to conserve JVM memory and speed up execution. The Realtime fork intends to extend the existing collections, by tweaking to remove any dynamic allocations at runtime, and to obtain low variance execution times whatever the input nature.

The newest version!

package com.carrotsearch.hppcrt;

import java.util.Iterator;

import com.carrotsearch.hppcrt.cursors.*;
import com.carrotsearch.hppcrt.predicates.*;
import com.carrotsearch.hppcrt.procedures.*;

/**
 * An associative container (alias: map, dictionary) from keys to (one or possibly more) values.
 * Object keys must fulfill the contract of {@link Object#hashCode()} and {@link Object#equals(Object)}.
 * 
 * Note that certain associative containers (like multimaps) may return the same key-value pair
 * multiple times from iterators.
 * 
 * @see ObjectContainer
 */
 @javax.annotation.Generated(
    date = "2017-07-11T19:16:23+0200",
    value = "KTypeVTypeAssociativeContainer.java") 
public interface ObjectLongAssociativeContainer
        extends Iterable>
{
    /**
     * Returns a cursor over the entries (key-value pairs) in this map. The iterator is
     * implemented as a cursor and it returns the same cursor instance on every
     * call to {@link Iterator#next()}. To read the current key and value use the cursor's
     * public fields. An example is shown below.
     *      * for (IntShortCursor c : intShortMap)
     * {
     *     System.out.println("index=" + c.index
     *       + " key=" + c.key
     *       + " value=" + c.value);
     * }
     * 
     * 
     * The index field inside the cursor gives the internal index inside
     * the container's implementation. The interpretation of this index depends on
     * to the container.
     */
    @Override
    Iterator> iterator();

    /**
     * Returns true if this container has an association to a value for
     * the given key.
     */
    boolean containsKey(KType key);

    /**
     * @return Returns the current size (number of assigned keys) in the container.
     */
    int size();

    /**
     * Return the maximum number of keys this container is guaranteed to hold without reallocating.
     * The time for calculating the container's capacity may take O(n) time.
     */
    int capacity();

    /**
     * @return Return true if this hash map contains no assigned keys.
     */
    boolean isEmpty();

    /**
     * Removes all keys (and associated values) present in a given container.
     * 
     * @return Returns the number of elements actually removed as a result of this call.
     */
    int removeAll(ObjectContainer container);

    /**
     * Removes all keys (and associated values) for which the predicate on keys returns true.
     * 
     * @return Returns the number of elements actually removed as a result of this call.
     */
    int removeAll(ObjectPredicate predicate);

    /**
     * Removes all keys (and associated values) for which the predicate on (key, value) pairs returns true.
     * 
     * @return Returns the number of elements actually removed as a result of this call.
     */
    int removeAll(ObjectLongPredicate predicate);

    /**
     * Applies a given procedure to all keys-value pairs in this container. Returns the argument (any
     * subclass of {@link ObjectLongProcedure}. This lets the caller to call methods of the argument
     * by chaining the call (even if the argument is an anonymous type) to retrieve computed values,
     * for example.
     */
    > T forEach(T procedure);

    /**
     * Applies a predicate to container elements, as long as the predicate
     * returns true. The iteration is interrupted otherwise.
     * Returns the argument (any
     * subclass of {@link ObjectLongPredicate}. This lets the caller to call methods of the argument
     * by chaining the call (even if the argument is an anonymous type) to retrieve computed values,
     * for example.
     * 
     * The iteration is continued as long as the predicate returns true.
     */
    > T forEach(T predicate);

    /**
     * Returns a collection view of keys of this container. The returned collection is a view
     * over the key set and any modifications (if allowed) introduced to the collection will
     * propagate to the associative container immediately.
     */
    ObjectCollection keys();

    /**
     * Returns a collection view of all values present in this container. The returned collection is a view
     * over the value set and any modifications (if allowed) introduced to the collection will
     * propagate to the associative container immediately.
     */
    LongCollection values();
}