java.util

Class Dictionary<K,V>

  • Direct Known Subclasses:
    Hashtable

    public abstract class Dictionary<K,V>
    extends Object
    The Dictionary class is the abstract parent of any class, such as Hashtable, which maps keys to values. Every key and every value is an object. In any one Dictionary object, every key is associated with at most one value. Given a Dictionary and a key, the associated element can be looked up. Any non-null object can be used as a key and as a value.

    As a rule, the equals method should be used by implementations of this class to decide if two keys are the same.

    NOTE: This class is obsolete. New implementations should implement the Map interface, rather than extending this class.

    Since:
    JDK1.0
    See Also:
    Map, Object.equals(java.lang.Object), Object.hashCode(), Hashtable
    • Constructor Summary

      Constructors 
      Constructor and Description
      Dictionary()
      Sole constructor.

        

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      abstract Enumeration<V> elements()
      Returns an enumeration of the values in this dictionary.
      abstract V get(Object key)
      Returns the value to which the key is mapped in this dictionary.
      abstract boolean isEmpty()
      Tests if this dictionary maps no keys to value.
      abstract Enumeration<K> keys()
      Returns an enumeration of the keys in this dictionary.
      abstract V put(K key, V value)
      Maps the specified key to the specified value in this dictionary.
      abstract V remove(Object key)
      Removes the key (and its corresponding value) from this dictionary.
      abstract int size()
      Returns the number of entries (distinct keys) in this dictionary.

        

    • Constructor Detail

      • Dictionary

        public Dictionary()
        Sole constructor. (For invocation by subclass constructors, typically implicit.)
    • Method Detail

      • size

        public abstract int size()
        Returns the number of entries (distinct keys) in this dictionary.
        Returns:
        the number of keys in this dictionary.
      • isEmpty

        public abstract boolean isEmpty()
        Tests if this dictionary maps no keys to value. The general contract for the isEmpty method is that the result is true if and only if this dictionary contains no entries.
        Returns:
        true if this dictionary maps no keys to values; false otherwise.
      • keys

        public abstract Enumeration<K> keys()
        Returns an enumeration of the keys in this dictionary. The general contract for the keys method is that an Enumeration object is returned that will generate all the keys for which this dictionary contains entries.
        Returns:
        an enumeration of the keys in this dictionary.
        See Also:
        elements(), Enumeration
      • elements

        public abstract Enumeration<V> elements()
        Returns an enumeration of the values in this dictionary. The general contract for the elements method is that an Enumeration is returned that will generate all the elements contained in entries in this dictionary.
        Returns:
        an enumeration of the values in this dictionary.
        See Also:
        keys(), Enumeration
      • get

        public abstract V get(Object key)
        Returns the value to which the key is mapped in this dictionary. The general contract for the isEmpty method is that if this dictionary contains an entry for the specified key, the associated value is returned; otherwise, null is returned.
        Parameters:
        key - a key in this dictionary. null if the key is not mapped to any value in this dictionary.
        Returns:
        the value to which the key is mapped in this dictionary;
        Throws:
        NullPointerException - if the key is null.
        See Also:
        put(java.lang.Object, java.lang.Object)
      • put

        public abstract V put(K key,
            V value)
        Maps the specified key to the specified value in this dictionary. Neither the key nor the value can be null.

        If this dictionary already contains an entry for the specified key, the value already in this dictionary for that key is returned, after modifying the entry to contain the new element.

        If this dictionary does not already have an entry for the specified key, an entry is created for the specified key and value, and null is returned.

        The value can be retrieved by calling the get method with a key that is equal to the original key.

        Parameters:
        key - the hashtable key.
        value - the value.
        Returns:
        the previous value to which the key was mapped in this dictionary, or null if the key did not have a previous mapping.
        Throws:
        NullPointerException - if the key or value is null.
        See Also:
        Object.equals(java.lang.Object), get(java.lang.Object)
      • remove

        public abstract V remove(Object key)
        Removes the key (and its corresponding value) from this dictionary. This method does nothing if the key is not in this dictionary.
        Parameters:
        key - the key that needs to be removed.
        Returns:
        the value to which the key had been mapped in this dictionary, or null if the key did not have a mapping.
        Throws:
        NullPointerException - if key is null.

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Version en cache

21/11/2024 21:40:40 Cette version de la page est en cache (à la date du 21/11/2024 21:40:40) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/util/dictionary.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, Dictionary

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut