Hashtable (Java Platform SE 8)

java.lang.Object
- java.util.Dictionary<K,V>
- - java.util.Hashtable<K,V>

すべての実装されたインタフェース:

Serializable, Cloneable, Map<K,V>

直系の既知のサブクラス:

Properties, UIDefaults
```
public class Hashtable<K,V>
extends Dictionary<K,V>
implements Map<K,V>, Cloneable, Serializable
```
このクラスは、ハッシュ表(キーを値にマップ)を実装します。nullオブジェクト以外であれば、どのオブジェクトでもキーや値に使用することができます。
ハッシュ表にオブジェクトを格納したり、そこから取り出したりするには、キーとして使用するオブジェクトに、hashCodeメソッドとequalsメソッドが実装されていなければなりません。
Hashtableのインスタンスには、その性能に影響を与える2つのパラメータである初期容量および負荷係数があります。容量はハッシュ表のバケット数であり、初期容量は単純にハッシュ表が作成された時点での容量です。ハッシュ表はオープンであることに注意してください。「ハッシュの衝突」という、1つのバケットが複数のエントリを格納する現象があり、その場合それらのエントリはシーケンシャル・サーチされることになります。負荷係数は、ハッシュ表がどの程度いっぱいになると、その容量が自動的に増加されるかの基準です。初期容量と負荷係数パラメータは、実装のヒントに過ぎません。rehashメソッドがいつ呼び出されるか、および呼び出されるかどうかは、実装により異なります。
通常、デフォルトの負荷係数(.75)では、時間コストとスペース・コストの釣合いを取ります。この値を大きくするとスペースのオーバーヘッドは減少しますが、エントリを参照するための時間のコストは増加し、getおよびputを含むほとんどのHashtableオペレーションが影響を受けます。
初期容量により、浪費スペースと(時間のかかる) rehashオペレーションの需要との間の釣合いが制御されます。初期容量が、Hashtableの格納するエントリの最大数を負荷係数で割った値より大きい場合、rehashオペレーションは起こりません。ただし、初期容量を高く設定しすぎると、スペースの浪費になります。
Hashtableに多くのエントリを入れる場合は、この表を十分に大きな容量で作成する方が、必要に応じてハッシュを自動的にやり直して表を大きくするよりも、エントリを効率的に挿入することができます。
この例は、数値のハッシュ表を作成します。この例では、数値の名前をキーとして使います。
```
   
   Hashtable<String, Integer> numbers
     = new Hashtable<String, Integer>();
   numbers.put("one", 1);
   numbers.put("two", 2);
   numbers.put("three", 3);
```
数値を取り出すには、次のコードを使います。
```
   
   Integer n = numbers.get("two");
   if (n != null) {
     System.out.println("two = " + n);
   }
```
このクラスのすべてのコレクション・ビュー・メソッドによって返されるコレクションのiteratorメソッドによって返されるイテレータは、フェイルファストです。イテレータの作成後に、イテレータ自体のremoveメソッド以外の方法でHashtableが構造的に変更されると、イテレータはConcurrentModificationExceptionをスローします。このように、並行して変更が行われると、イテレータは、将来の予測できない時点において予測できない動作が発生する危険を回避するために、ただちにかつ手際よく例外をスローします。Hashtableのキー・メソッドおよび要素メソッドによって返されるEnumerationsは、フェイルファストではありません。
通常、非同期の並行変更がある場合、確かな保証を行うことは不可能なので、イテレータのフェイルファストの動作を保証することはできません。フェイルファスト・イテレータは最善努力原則に基づき、ConcurrentModificationExceptionをスローします。したがって、正確を期すためにこの例外に依存するプログラムを書くことは誤りです。イテレータのフェイルファストの動作はバグを検出するためにのみ使用すべきです。
このクラスは、Java 2プラットフォームv1.2の時点でMapインタフェースを実装するように改良された結果、Java Collections Frameworkのメンバーとなりました。新しいコレクションの実装とは異なり、Hashtableは同期をとります。スレッドセーフな実装が必要ない場合は、Hashtableの代わりにHashMapを使用することをお薦めします。スレッドセーフで高度な並列実装が必要な場合は、Hashtableの代わりにConcurrentHashMapを使用することをお薦めします。
導入されたバージョン:

JDK1.0

関連項目:

Object.equals(java.lang.Object), Object.hashCode(), rehash(), Collection, Map, HashMap, TreeMap, 直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`Hashtable()` デフォルトの初期容量(11)と負荷係数(0.75)で新規の空のハッシュ表を生成します。
`Hashtable(int initialCapacity)` 指定された初期容量およびデフォルトの負荷係数(0.75)で新しい空のハッシュ表を生成します。
`Hashtable(int initialCapacity, float loadFactor)` 指定された初期容量と負荷係数で新しい空のハッシュ表を生成します。
`Hashtable(Map<? extends K,? extends V> t)` 指定されたMapと同じマッピングで新しいハッシュ表を生成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`clear()` このハッシュ表を消去して、キーがない状態にします。
`Object`	`clone()` ハッシュ表のコピーを作成します。
`V`	`compute(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)` 指定されたキーと現在マップされている値に対するマッピングの計算を試みます(現在のマッピングが存在しない場合は`null`)。
`V`	`computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)` 指定されたキーがまだ値に関連付けられていない(または`null`にマップされている)場合、指定されたマッピング関数を使用してその値の計算を試行し、`null`でない場合はそれをこのマップに入力します。
`V`	`computeIfPresent(K key, BiFunction<? super K,? super V,? extends V> remappingFunction)` 指定されたキーの値が存在していてnull以外の場合、キーと現在マップされている値から新しいマッピングの計算を試みます。
`boolean`	`contains(Object value)` 指定された値にマップされているキーが、ハッシュ表にあるかどうかを判定します。
`boolean`	`containsKey(Object key)` 指定されたオブジェクトが、ハッシュ表のキーかどうかを判定します。
`boolean`	`containsValue(Object value)` このハッシュ表が1つまたは複数のキーをこの値にマッピングする場合にtrueを返します。
`Enumeration<V>`	`elements()` ハッシュ表にある値のリストを返します。
`Set<Map.Entry<K,V>>`	`entrySet()` このマップに含まれるマッピングの`Set`ビューを返します。
`boolean`	`equals(Object o)` Mapインタフェースでの定義に従って、指定されたObjectとこのMapを比較して等しいかどうかを判定します。
`void`	`forEach(BiConsumer<? super K,? super V> action)` このマップのすべてのエントリの処理が完了するかアクションから例外がスローされるまで、各エントリに対して指定されたアクションを実行します。
`V`	`get(Object key)` 指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合は`null`を返します。
`V`	`getOrDefault(Object key, V defaultValue)` 指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合は`defaultValue`を返します。
`int`	`hashCode()` Mapインタフェースの定義に従って、このMapのハッシュ・コード値を返します。
`boolean`	`isEmpty()` 値にマップされているキーが、ハッシュ表にあるかどうかを判定します。
`Enumeration<K>`	`keys()` ハッシュ表にあるキーのリストを返します。
`Set<K>`	`keySet()` このマップに含まれるキーの`Set`ビューを返します。
`V`	`merge(K key, V value, BiFunction<? super V,? super V,? extends V> remappingFunction)` 指定されたキーがまだ値と関連付けられていないかnullと関連付けられている場合、指定されたnull以外の値に関連付けます。
`V`	`put(K key, V value)` このハッシュ表で、指定された`key`を指定された`value`にマップします。
`void`	`putAll(Map<? extends K,? extends V> t)` 指定したマップからこのハッシュ表にすべてのマッピングをコピーします。
`V`	`putIfAbsent(K key, V value)` 指定されたキーがまだ値に関連付けられていない(または、`null`にマップされている)場合は、それを指定された値に関連付けて`null`を返します。それ以外の場合は、現在の値を返します。
`protected void`	`rehash()` ハッシュ表の容量を増やし、それを内部的に再編成して、エントリを調整してアクセスをより効率的にします。
`V`	`remove(Object key)` キー(およびそれに対応する値)をハッシュ表から削除します。
`boolean`	`remove(Object key, Object value)` 指定された値に指定されたキーが現在マッピングされている場合にのみ、そのキーのエントリを削除します。
`V`	`replace(K key, V value)` 指定されたキーがなんらかの値に現在マッピングされている場合にのみ、そのキーのエントリを置換します。
`boolean`	`replace(K key, V oldValue, V newValue)` 指定されたキーが指定された値に現在マッピングされている場合にのみ、そのキーのエントリを置換します。
`void`	`replaceAll(BiFunction<? super K,? super V,? extends V> function)` すべてのエントリが処理されるか、または関数が例外をスローするまで、各エントリの値を、そのエントリで指定された関数を呼び出した結果で置換します。
`int`	`size()` ハッシュ表にあるキーの数を返します。
`String`	`toString()` この`Hashtable`オブジェクトの文字列表現を、ASCII文字「`,` 」(カンマとスペース)で区切り、カッコで囲んだ一連のエントリの形式で返します。
`Collection<V>`	`values()` このマップに含まれる値の`Collection`ビューを返します。

クラス java.lang.Objectから継承されたメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - Hashtable
```
public Hashtable(int initialCapacity,
                 float loadFactor)
```
    指定された初期容量と負荷係数で新しい空のハッシュ表を生成します。
    
    パラメータ:
    
    initialCapacity - ハッシュ表の初期容量。
    
    loadFactor - ハッシュ表の負荷係数。
    
    例外:
    
    IllegalArgumentException - 初期容量がゼロよりも小さい場合、または負荷係数が正でない場合。
  - Hashtable
```
public Hashtable(int initialCapacity)
```
    指定された初期容量およびデフォルトの負荷係数(0.75)で新しい空のハッシュ表を生成します。
    
    パラメータ:
    
    initialCapacity - ハッシュ表の初期容量。
    
    例外:
    
    IllegalArgumentException - 初期容量が0よりも小さい場合。
  - Hashtable
```
public Hashtable()
```
    デフォルトの初期容量(11)と負荷係数(0.75)で新規の空のハッシュ表を生成します。
  - Hashtable
```
public Hashtable(Map<? extends K,? extends V> t)
```
    指定されたMapと同じマッピングで新しいハッシュ表を生成します。指定されたMapのマッピングを保持するのに十分な初期容量、およびデフォルトの負荷係数(0.75)で、ハッシュ表は作成されます。
    
    パラメータ:
    
    t - マッピングがこのマップに配置されるマップ。
    
    例外:
    
    NullPointerException - 指定されたマップがnullの場合。
    
    導入されたバージョン:
    
    1.2
- メソッドの詳細
  - size
```
public int size()
```
    ハッシュ表にあるキーの数を返します。
    
    定義:
    
    size、インタフェース: Map<K,V>
    
    定義:
    
    size、クラス: Dictionary<K,V>
    
    戻り値:
    
    ハッシュ表にあるキーの数。
  - isEmpty
```
public boolean isEmpty()
```
    値にマップされているキーが、ハッシュ表にあるかどうかを判定します。
    
    定義:
    
    isEmpty、インタフェース: Map<K,V>
    
    定義:
    
    isEmpty、クラス: Dictionary<K,V>
    
    戻り値:
    
    値にマップされているキーがハッシュ表にない場合はtrue、ある場合はfalse。
  - keys
```
public Enumeration<K> keys()
```
    ハッシュ表にあるキーのリストを返します。
    
    定義:
    
    keys、クラス: Dictionary<K,V>
    
    戻り値:
    
    ハッシュ表にあるキーのリスト。
    
    関連項目:
    
    Enumeration, elements(), keySet(), Map
  - elements
```
public Enumeration<V> elements()
```
    ハッシュ表にある値のリストを返します。これらの要素を順次に取り出すには、Enumerationのメソッドを使用します。
    
    定義:
    
    elements、クラス: Dictionary<K,V>
    
    戻り値:
    
    ハッシュ表にある値のリスト。
    
    関連項目:
    
    Enumeration, keys(), values(), Map
  - contains
```
public boolean contains(Object value)
```
    指定された値にマップされているキーが、ハッシュ表にあるかどうかを判定します。この操作は、containsKeyメソッドよりも負荷がかかります。
    このメソッドは、機能の点でcontainsValue (コレクション・フレームワークのMapインタフェースの一部)と同じです。
    
    パラメータ:
    
    value - 検索する値
    
    戻り値:
    
    あるキーが、equalsメソッドで決められている、ハッシュ表のvalue引数にマッピングする場合はtrue、そうでない場合はfalse。
    
    例外:
    
    NullPointerException - 値がnullの場合
  - containsValue
```
public boolean containsValue(Object value)
```
    このハッシュ表が1つまたは複数のキーをこの値にマッピングする場合にtrueを返します。
    このメソッドは、機能の点でcontains (Mapインタフェースに先行する)と同じです。
    
    定義:
    
    containsValue、インタフェース: Map<K,V>
    
    パラメータ:
    
    value - ハッシュ表にあるかどうかを判定される値
    
    戻り値:
    
    このマップが1つまたは複数のキーを指定された値にマッピングしている場合はtrue
    
    例外:
    
    NullPointerException - 値がnullの場合
    
    導入されたバージョン:
    
    1.2
  - containsKey
```
public boolean containsKey(Object key)
```
    指定されたオブジェクトが、ハッシュ表のキーかどうかを判定します。
    
    定義:
    
    containsKey、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 使用可能なキー
    
    戻り値:
    
    equalsメソッドで決められているように、指定されたオブジェクトがこのハッシュ表のキーである場合はtrue、そうでない場合はfalse。
    
    例外:
    
    NullPointerException - キーがnullの場合
    
    関連項目:
    
    contains(Object)
  - get
```
public V get(Object key)
```
    指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合はnullを返します。
    つまり、このメソッドは、(key.equals(k))となるキーkから値vへのマッピングがこのマップに含まれている場合はvを返し、それ以外の場合はnullを返します。(このようなマッピングは1つのみ存在できます。)
    
    定義:
    
    get、インタフェース: Map<K,V>
    
    定義:
    
    get、クラス: Dictionary<K,V>
    
    パラメータ:
    
    key - 関連付けられた値が返されるキー
    
    戻り値:
    
    指定されたキーがマップされている値。このマップにそのキーのマッピングが含まれていない場合はnull
    
    例外:
    
    NullPointerException - 指定されたキーがnullである場合
    
    関連項目:
    
    put(Object, Object)
  - rehash
```
protected void rehash()
```
    ハッシュ表の容量を増やし、それを内部的に再編成して、エントリを調整してアクセスをより効率的にします。ハッシュ表にあるキーの数がハッシュ表の容量と負荷係数を超えると、このメソッドが自動的に呼び出されます。
  - put
```
public V put(K key,
             V value)
```
    このハッシュ表で、指定されたkeyを指定されたvalueにマップします。キーや値はnullにすることはできません。
    valueを取得するには、元のkeyに等しいkeyを指定してgetメソッドを呼び出します。
    
    定義:
    
    put、インタフェース: Map<K,V>
    
    定義:
    
    put、クラス: Dictionary<K,V>
    
    パラメータ:
    
    key - ハッシュ表キー
    
    value - 値
    
    戻り値:
    
    ハッシュ表の指定されたキーの前の値。それがない場合はnull
    
    例外:
    
    NullPointerExceptionキーまたは値がnullの場合
    
    関連項目:
    
    Object.equals(Object), get(Object)
  - remove
```
public V remove(Object key)
```
    キー(およびそれに対応する値)をハッシュ表から削除します。そのキーがハッシュ表にない場合は、何も行いません。
    
    定義:
    
    remove、インタフェース: Map<K,V>
    
    定義:
    
    remove、クラス: Dictionary<K,V>
    
    パラメータ:
    
    key - 削除するキー
    
    戻り値:
    
    ハッシュ表でそのキーにマップされている値。マップされている値がない場合はnull
    
    例外:
    
    NullPointerException - キーがnullの場合
  - putAll
```
public void putAll(Map<? extends K,? extends V> t)
```
    指定したマップからこのハッシュ表にすべてのマッピングをコピーします。これにより、ハッシュ表が指定されたマップ内に現在あるキーのすべてに対して持っていたマッピングが置き換えられます。
    
    定義:
    
    putAll、インタフェース: Map<K,V>
    
    パラメータ:
    
    t - このマップに格納されるマッピング
    
    例外:
    
    NullPointerException - 指定されたマップがnullの場合
    
    導入されたバージョン:
    
    1.2
  - clear
```
public void clear()
```
    このハッシュ表を消去して、キーがない状態にします。
    
    定義:
    
    clear、インタフェース: Map<K,V>
  - clone
```
public Object clone()
```
    ハッシュ表のコピーを作成します。ハッシュ表の構造自体はすべてコピーされますが、キーおよび値は複製されません。これは、比較的負担の大きい操作です。
    
    オーバーライド:
    
    clone、クラス: Object
    
    戻り値:
    
    ハッシュ表の複製
    
    関連項目:
    
    Cloneable
  - toString
```
public String toString()
```
    このHashtableオブジェクトの文字列表現を、ASCII文字「, 」(カンマとスペース)で区切り、カッコで囲んだ一連のエントリの形式で返します。各エントリはキー、等符号=、および関連した要素として描画され、toStringメソッドはキーおよび要素を文字列に変換するために使用されます。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    
    このハッシュ表の文字列表現
  - keySet
```
public Set<K> keySet()
```
    このマップに含まれるキーのSetビューを返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットの反復処理中にマップが変更された場合、反復処理の結果は定義されていません(イテレータ自身のremoveオペレーションを除く)。セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。addまたはaddAllオペレーションはサポートしていません。
    
    定義:
    
    keySet、インタフェース: Map<K,V>
    
    戻り値:
    
    マップに含まれているキーのセット・ビュー
    
    導入されたバージョン:
    
    1.2
  - entrySet
```
public Set<Map.Entry<K,V>> entrySet()
```
    このマップに含まれるマッピングのSetビューを返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットの反復処理中にマップが変更された場合、反復処理の結果は定義されていません(イテレータ自身のremoveオペレーション、またはイテレータにより返されるマップ・エントリに対するsetValueオペレーションを除く)。セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。addまたはaddAllオペレーションはサポートしていません。
    
    定義:
    
    entrySet、インタフェース: Map<K,V>
    
    戻り値:
    
    マップ内に保持されているマッピングのセット・ビュー
    
    導入されたバージョン:
    
    1.2
  - values
```
public Collection<V> values()
```
    このマップに含まれる値のCollectionビューを返します。コレクションはマップと連動しているので、マップに対する変更はコレクションに反映され、またコレクションに対する変更はマップに反映されます。コレクションの反復処理中にマップが変更された場合、反復処理の結果は定義されていません(イテレータ自身のremoveオペレーションを除く)。コレクションは要素の削除をサポートします。Iterator.remove、Collection.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。addまたはaddAllオペレーションはサポートしていません。
    
    定義:
    
    values、インタフェース: Map<K,V>
    
    戻り値:
    
    マップ内に含まれている値のコレクション・ビュー
    
    導入されたバージョン:
    
    1.2
  - equals
```
public boolean equals(Object o)
```
    Mapインタフェースでの定義に従って、指定されたObjectとこのMapを比較して等しいかどうかを判定します。
    
    定義:
    
    equals、インタフェース: Map<K,V>
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    
    o - Hashtableと等しいかどうかを比較するオブジェクト
    
    戻り値:
    
    指定されたObjectがこのMapと等しい場合はtrue
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Map.equals(Object)
  - hashCode
```
public int hashCode()
```
    Mapインタフェースの定義に従って、このMapのハッシュ・コード値を返します。
    
    定義:
    
    hashCode、インタフェース: Map<K,V>
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    
    このオブジェクトのハッシュ・コード値。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Map.hashCode()
  - getOrDefault
```
public V getOrDefault(Object key,
                      V defaultValue)
```
    インタフェースからコピーされた説明: Map
    
    指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合はdefaultValueを返します。
    
    定義:
    
    getOrDefault、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 関連付けられた値が返されるキー
    
    defaultValue - キーのデフォルト・マッピング
    
    戻り値:
    
    指定されたキーがマップされている値。このマップにそのキーのマッピングが含まれていない場合はdefaultValue
  - forEach
```
public void forEach(BiConsumer<? super K,? super V> action)
```
    インタフェースからコピーされた説明: Map
    
    このマップのすべてのエントリの処理が完了するかアクションから例外がスローされるまで、各エントリに対して指定されたアクションを実行します。実装クラスで指定されない場合は、エントリ・セットの反復の順序でアクションが実行されます(反復順序が指定されている場合)。アクションによってスローされた例外は、呼出し側に中継されます。
    
    定義:
    
    forEach、インタフェース: Map<K,V>
    
    パラメータ:
    
    action - 各エントリに対して実行されるアクション
  - replaceAll
```
public void replaceAll(BiFunction<? super K,? super V,? extends V> function)
```
    インタフェースからコピーされた説明: Map
    
    すべてのエントリが処理されるか、または関数が例外をスローするまで、各エントリの値を、そのエントリで指定された関数を呼び出した結果で置換します。関数によってスローされた例外は、呼出し側に中継されます。
    
    定義:
    
    replaceAll、インタフェース: Map<K,V>
    
    パラメータ:
    
    function - 各エントリに適用する関数
  - putIfAbsent
```
public V putIfAbsent(K key,
                     V value)
```
    インタフェースからコピーされた説明: Map
    
    指定されたキーがまだ値に関連付けられていない(または、nullにマップされている)場合は、それを指定された値に関連付けてnullを返します。それ以外の場合は、現在の値を返します。
    
    定義:
    
    putIfAbsent、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 指定された値が関連付けられるキー
    
    value - 指定されたキーに関連付けられる値
    
    戻り値:
    
    指定されたキーに関連付けられた以前の値。キーのマッピングがなかった場合はnull。(また、実装がnull値をサポートしている場合、戻り値nullは、以前にマップでキーとnullが関連付けられていたことを示す場合もある。)
  - remove
```
public boolean remove(Object key,
                      Object value)
```
    インタフェースからコピーされた説明: Map
    
    指定された値に指定されたキーが現在マッピングされている場合にのみ、そのキーのエントリを削除します。
    
    定義:
    
    remove、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 指定された値が関連付けられるキー
    
    value - 指定されたキーに関連付けられていると予想される値
    
    戻り値:
    
    値が削除された場合はtrue
  - replace
```
public boolean replace(K key,
                       V oldValue,
                       V newValue)
```
    インタフェースからコピーされた説明: Map
    
    指定されたキーが指定された値に現在マッピングされている場合にのみ、そのキーのエントリを置換します。
    
    定義:
    
    replace、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 指定された値が関連付けられるキー
    
    oldValue - 指定されたキーに関連付けられていると予想される値
    
    newValue - 指定されたキーに関連付けられる値
    
    戻り値:
    
    値が置換された場合はtrue
  - replace
```
public V replace(K key,
                 V value)
```
    インタフェースからコピーされた説明: Map
    
    指定されたキーがなんらかの値に現在マッピングされている場合にのみ、そのキーのエントリを置換します。
    
    定義:
    
    replace、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 指定された値が関連付けられるキー
    
    value - 指定されたキーに関連付けられる値
    
    戻り値:
    
    指定されたキーに関連付けられた以前の値。キーのマッピングがなかった場合はnull。(また、実装がnull値をサポートしている場合、戻り値nullは、以前にマップでキーとnullが関連付けられていたことを示す場合もある。)
  - computeIfAbsent
```
public V computeIfAbsent(K key,
                         Function<? super K,? extends V> mappingFunction)
```
    インタフェースからコピーされた説明: Map
    指定されたキーがまだ値に関連付けられていない(またはnullにマップされている)場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。
    関数がnullを返した場合、マッピングは記録されません。関数自体が(非チェック)例外をスローした場合、その例外は再スローされ、マッピングは記録されません。もっとも一般的な用途は、次のように初期のマップされた値またはメモ化された結果として機能する新しいオブジェクトを構築することです。
```
 
 map.computeIfAbsent(key, k -> new Value(f(k)));
 
```
    または、1つのキーで複数の値をサポートする複数値マップMap<K,Collection<V>>を実装することです。
```
 
 map.computeIfAbsent(key, k -> new HashSet<V>()).add(v);
 
```
    定義:
    
    computeIfAbsent、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 指定された値が関連付けられるキー
    
    mappingFunction - 値を計算するための関数
    
    戻り値:
    
    指定されたキーに関連付けられている現在の(既存の、または計算された)値。計算された値がnullである場合はnull
  - computeIfPresent
```
public V computeIfPresent(K key,
                          BiFunction<? super K,? super V,? extends V> remappingFunction)
```
    インタフェースからコピーされた説明: Map
    
    指定されたキーの値が存在していてnull以外の場合、キーと現在マップされている値から新しいマッピングの計算を試みます。
    関数がnullを返した場合、マッピングは削除されます。関数自体が(非チェック)例外をスローした場合、その例外は再スローされ、現在のマッピングは変更されません。
    
    定義:
    
    computeIfPresent、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 指定された値が関連付けられるキー
    
    remappingFunction - 値を計算するための関数
    
    戻り値:
    
    指定されたキーに関連付けられる新しい値。存在しない場合はnull
  - compute
```
public V compute(K key,
                 BiFunction<? super K,? super V,? extends V> remappingFunction)
```
    インタフェースからコピーされた説明: Map
    指定されたキーと現在マップされている値に対するマッピングの計算を試みます(現在のマッピングが存在しない場合はnull)。たとえば、次のように、値のマッピングにString msgを作成または追加します。
```
 
 map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))
```
    (このような目的で使用するmerge()メソッドは、多くの場合、より単純です。)
    関数がnullを返した場合、マッピングは削除されます(最初から存在しない場合は、存在しないままです)。関数自体が(非チェック)例外をスローした場合、その例外は再スローされ、現在のマッピングは変更されません。
    定義:
    
    compute、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 指定された値が関連付けられるキー
    
    remappingFunction - 値を計算するための関数
    
    戻り値:
    
    指定されたキーに関連付けられる新しい値。存在しない場合はnull
  - merge
```
public V merge(K key,
               V value,
               BiFunction<? super V,? super V,? extends V> remappingFunction)
```
    インタフェースからコピーされた説明: Map
    指定されたキーがまだ値と関連付けられていないかnullと関連付けられている場合、指定されたnull以外の値に関連付けます。それ以外の場合は、指定された再マッピング関数の結果で関連する値を置換し、結果がnullの場合は削除します。このメソッドは、1つのキーに対する複数のマップされた値を結合するときに使用できます。たとえば、次のように、値のマッピングにString msgを作成または追加します。
```
 
 map.merge(key, msg, String::concat)
 
```
    関数がnullを返した場合、マッピングは削除されます。関数自体が(非チェック)例外をスローした場合、その例外は再スローされ、現在のマッピングは変更されません。
    定義:
    
    merge、インタフェース: Map<K,V>
    
    パラメータ:
    
    key - 結果値が関連付けられるキー
    
    value - キーに関連付けられた既存の値にマージされるnull以外の値。既存の値がない場合、またはキーにnull値が関連付けられている場合は、キーに関連付けられるnull以外の値
    
    remappingFunction - 値が存在する場合に値を再計算するための関数
    
    戻り値:
    
    指定されたキーに関連付けられた新しい値。キーに値が関連付けられなかった場合はnull

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

クラスHashtable<K,V>

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

Hashtable

Hashtable

Hashtable

Hashtable

メソッドの詳細

size

isEmpty

keys

elements

contains

containsValue

containsKey

get

rehash

put

remove

putAll

clear

clone

toString

keySet

entrySet

values

equals

hashCode

getOrDefault

forEach

replaceAll

putIfAbsent

remove

replace

replace

computeIfAbsent

computeIfPresent

compute

merge