モジュール java.base
パッケージ java.util

インタフェースMap.Entry<K,​V>

既知のすべての実装クラス:
AbstractMap.SimpleEntry, AbstractMap.SimpleImmutableEntry
含まれているインタフェース:
Map<K,​V>
public static interface Map.Entry<K,​V>
マップのエントリ(キーと値のペア)です。 Map.entrySetメソッドは、このクラスに属する要素を持つマップのコレクション・ビューを返します。 マップ・エントリへの参照を取得する唯一の方法は、このコレクション・ビューのイテレータから取得する方法です。 これらのMap.Entryオブジェクトは、反復処理中にだけ有効です。すなわち、マップ・エントリのsetValueオペレーション以外の方法でエントリがイテレータによって返されたあとに、基になっているマップが変更された場合、マップ・エントリの動作は定義されていません。
導入されたバージョン:
1.2
関連項目:
Map.entrySet()

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    static <K extends Comparable<? super K>,​ V>
    Comparator<Map.Entry<K,​V>>    		 comparingByKey()
    キーの自然順序でMap.Entryを比較するコンパレータを返します。
    static <K,​ V> Comparator<Map.Entry<K,​V>> comparingByKey​(Comparator<? super K> cmp)
    指定されたComparatorを使用してキーでMap.Entryを比較するコンパレータを返します。
    static <K,​ V extends Comparable<? super V>>
    Comparator<Map.Entry<K,​V>>    		 comparingByValue()
    値の自然順序でMap.Entryを比較するコンパレータを返します。
    static <K,​ V> Comparator<Map.Entry<K,​V>> comparingByValue​(Comparator<? super V> cmp)
    指定されたComparatorを使用して値でMap.Entryを比較するコンパレータを返します。
    boolean equals​(Object o)
    指定されたオブジェクトがエントリと等しいかどうかを比較します。
    K getKey()
    このエントリに対応するキーを返します。
    V getValue()
    このエントリに対応する値を返します。
    int hashCode()
    このマップ・エントリのハッシュ・コード値を返します。
    V setValue​(V value)
    このエントリに対応する値を、指定された値に置き換えます(オプションの操作)。

  • メソッドの詳細

    • getKey

      K getKey()
      このエントリに対応するキーを返します。
      戻り値:
      このエントリに対応するキー
      例外:
      IllegalStateException - 実装は、このエントリがその基になるマップから削除されている場合にこの例外をスローできる。ただし、必須ではない。

    • getValue

      V getValue()
      このエントリに対応する値を返します。 マッピングが(イテレータのremoveオペレーションによって)基になっているマップから削除されている場合は、この呼出しの結果は保証されません。
      戻り値:
      このエントリに対応する値
      例外:
      IllegalStateException - 実装は、このエントリがその基になるマップから削除されている場合にこの例外をスローできる。ただし、必須ではない。

    • setValue

      V setValue​(V value)
      このエントリに対応する値を、指定された値に置き換えます(オプションの操作)。 マップに書き込みます。 マッピングが(イテレータのremoveオペレーションによって)すでにマップから削除されている場合は、この呼出しの動作は保証されません。
      パラメータ:
      value - このエントリに格納される新しい値
      戻り値:
      エントリに対応する以前の値
      例外:
      UnsupportedOperationException - putオペレーションが基となるマップでサポートされない場合
      ClassCastException - 指定された値のクラスが原因で、基となるマップにその値を格納できない場合
      NullPointerException - 基となるマップがnull値を許可せず、指定された値がnullである場合
      IllegalArgumentException - この値の一部のプロパティが原因で、基となるマップにその値を格納できない場合
      IllegalStateException - 実装は、このエントリがその基になるマップから削除されている場合にこの例外をスローできる。ただし、必須ではない。

    • equals

      boolean equals​(Object o)
      指定されたオブジェクトがエントリと等しいかどうかを比較します。 指定されたオブジェクトもマップ・エントリであり、2つのエントリが同じマッピングを表す場合はtrueを返します。 つまり、2つのエントリe1とe2は、次のようになる場合に同じマッピングを表します。 
           (e1.getKey()==null ?
      e2.getKey()==null : e1.getKey().equals(e2.getKey()))  &&
     (e1.getValue()==null ?
      e2.getValue()==null : e1.getValue().equals(e2.getValue()))
      これにより、Map.Entryインタフェースの実装が異なる場合でも、equalsメソッドが正しく動作することが保証されます。
      オーバーライド:
      equals 、クラス:  Object
      パラメータ:
      o - このマップ・エントリと等しいかどうかが比較されるオブジェクト
      戻り値:
      指定されたオブジェクトがこのマップ・エントリと等しい場合はtrue
      関連項目:
      Object.hashCode()、HashMap

    • hashCode

      int hashCode()
      このマップ・エントリのハッシュ・コード値を返します。 マップ・エントリeのハッシュ・コードは、次のように定義されます。 
           (e.getKey()==null   ? 0 : e.getKey().hashCode()) ^
     (e.getValue()==null ? 0 : e.getValue().hashCode())
      これにより、Object.hashCodeの一般規約によって要求されるように、任意の2つのエントリe1とe2でe1.equals(e2)であれば、e1.hashCode()==e2.hashCode()となることが保証されます。
      オーバーライド:
      hashCode 、クラス:  Object
      戻り値:
      このマップ・エントリのハッシュ・コード値
      関連項目:
      Object.hashCode(), Object.equals(Object), equals(Object)

    • comparingByKey

      static <K extends Comparable<? super K>,​ V> Comparator<Map.Entry<K,​V>> comparingByKey()
      キーの自然順序でMap.Entryを比較するコンパレータを返します。

      返されるコンパレータは直列化可能で、エントリとnullキーを比較したときにNullPointerExceptionをスローします。

      型パラメータ:
      K - マップ・キーのComparable型
      V - マップ値の型
      戻り値:
      キーの自然順序でMap.Entryを比較するコンパレータ。
      導入されたバージョン:
      1.8
      関連項目:
      Comparable

    • comparingByValue

      static <K,​ V extends Comparable<? super V>> Comparator<Map.Entry<K,​V>> comparingByValue()
      値の自然順序でMap.Entryを比較するコンパレータを返します。

      返されるコンパレータは直列化可能で、エントリとnull値を比較したときにNullPointerExceptionをスローします。

      型パラメータ:
      K - マップ・キーの型
      V - マップ値のComparable型
      戻り値:
      値の自然順序でMap.Entryを比較するコンパレータ。
      導入されたバージョン:
      1.8
      関連項目:
      Comparable

    • comparingByKey

      static <K,​ V> Comparator<Map.Entry<K,​V>> comparingByKey​(Comparator<? super K> cmp)
      指定されたComparatorを使用してキーでMap.Entryを比較するコンパレータを返します。

      指定されたコンパレータが直列化可能の場合、返されるコンパレータも直列化可能になります。

      型パラメータ:
      K - マップ・キーの型
      V - マップ値の型
      パラメータ:
      cmp - キーのComparator
      戻り値:
      キーでMap.Entryを比較するコンパレータ。
      導入されたバージョン:
      1.8

    • comparingByValue

      static <K,​ V> Comparator<Map.Entry<K,​V>> comparingByValue​(Comparator<? super V> cmp)
      指定されたComparatorを使用して値でMap.Entryを比較するコンパレータを返します。

      指定されたコンパレータが直列化可能の場合、返されるコンパレータも直列化可能になります。

      型パラメータ:
      K - マップ・キーの型
      V - マップ値の型
      パラメータ:
      cmp - 値Comparator
      戻り値:
      値でMap.Entryを比較するコンパレータ。
      導入されたバージョン:
      1.8