Map.Entry (Java Platform SE 8)

既知のすべての実装クラス:

AbstractMap.SimpleEntry, AbstractMap.SimpleImmutableEntry

含まれているインタフェース:

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

導入されたバージョン:

1.2

関連項目:

Map.entrySet()

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド抽象メソッドデフォルト・メソッド
修飾子と型	メソッド	説明
`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

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

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

メソッドのサマリー

メソッドの詳細

getKey

getValue

setValue

equals

hashCode

comparingByKey

comparingByValue

comparingByKey

comparingByValue