package containers;

import java.util.Enumeration;

/**
 * An abstract container.
 *
 * Version 2.
 *
 * @author Alan L. Cox
 * @since 02/22/01
 */
public interface IContainer {

    /**
     * If there is an object associated with key
     * then this object is returned else null is returned.
     */
    public Object find(Object key);

    /**
     * Afterwards, find(key) returns null, and if there is
     * an object associated with key then this object is
     * returned else null is returned.
     */
    public Object remove(Object key);

    /**
     * (key, value) is stored in this container with no
     * duplication and such that find(key) returns value.
     */
    public void insert(Object key, Object value);

    /**
     * Returns an Enumeration of the container.
     */
    public Enumeration enumeration();
}