Hashtable クラス

定義

名前空間:: Java.Util

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

このクラスは、キーを値にマップするハッシュテーブルを実装します。

[Android.Runtime.Register("java/util/Hashtable", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class Hashtable : Java.Util.Dictionary, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IMap

[<Android.Runtime.Register("java/util/Hashtable", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type Hashtable = class
    inherit Dictionary
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IMap

継承: Object

JavaObject

Object

Dictionary
Hashtable

属性: RegisterAttribute JavaTypeParametersAttribute

実装: IJavaObject IJavaPeerable ISerializable ICloneable IMap IDisposable

注釈

このクラスは、キーを値にマップするハッシュテーブルを実装します。 null以外のオブジェクトは、キーまたは値として使用できます。

ハッシュテーブルからオブジェクトを正常に格納および取得するには、キーとして使用されるオブジェクトで hashCode メソッドと equals メソッドを実装する必要があります。

Hashtableのインスタンスには、そのパフォーマンスに影響を与える 2 つのパラメーター (初期容量と負荷係数) があります。容量はハッシュテーブル内のバケットの数であり、初期容量はハッシュテーブルが作成された時点の容量です。ハッシュテーブルが開いていることに注意してください。"ハッシュ競合" の場合、1 つのバケットに複数のエントリが格納されます。これは順番に検索する必要があります。 読み込み係数は、ハッシュテーブルの容量が自動的に増加する前に、どの程度完全に取得できるかを示す測定値です。初期容量と負荷係数のパラメーターは、実装に対するヒントにすぎません。リハッシュメソッドが呼び出されるタイミングと呼び出しの正確な詳細は、実装に依存します。

一般に、既定の負荷係数 (.75) は、時間コストと空間コストの間で良好なトレードオフを提供します。値を大きくすると、領域のオーバーヘッドは減少しますが、エントリを検索するための時間コストが増加します (Hashtableやgetなど、ほとんどのput操作に反映されます)。

初期容量は、無駄な領域と、時間がかかる rehash 操作の必要性とのトレードオフを制御します。初期容量が、rehashに含まれるエントリの最大数を読み込み係数で割った値を超える場合、操作は発生Hashtable。ただし、初期容量を高く設定すると、領域が無駄になります。

多数のエントリを Hashtableに作成する場合、十分に大きな容量でエントリを作成すると、テーブルを拡張するために必要に応じて自動再ハッシュを実行するよりも、エントリをより効率的に挿入できる場合があります。

この例では、数値のハッシュテーブルを作成します。数字の名前をキーとして使用します。

{@code
              Hashtable<String, Integer> numbers
                = new Hashtable<String, Integer>();
              numbers.put("one", 1);
              numbers.put("two", 2);
              numbers.put("three", 3);}

数値を取得するには、次のコードを使用します。

{@code
              Integer n = numbers.get("two");
              if (n != null) {
                System.out.println("two = " + n);
              }}

このクラスのすべての "コレクションビューメソッド" によって返されるコレクションの iterator メソッドによって返される反復子は、 <em>fail-fast</em>: 反復子の作成後にいつでも Hashtable が構造的に変更されている場合、反復子の独自の remove メソッドを除き、反復子は ConcurrentModificationExceptionをスローします。したがって、同時変更が発生した場合、反復子は、将来不確定な時点で任意の非決定論的な動作を危険にさらすのではなく、迅速かつクリーンに失敗します。 Hashtable の #keys keys および #elements elements メソッドによって返される列挙体は、 <em>not</em> fail-fast です。列挙が作成された後にいつでも Hashtable が構造的に変更された場合、列挙の結果は未定義になります。

反復子のフェイルファスト動作は、一般的に言えば、非同期の同時変更が存在する場合にハード保証することは不可能であるため、保証できないことに注意してください。フェイルファスト反復子は、ベストエフォートベースで ConcurrentModificationException をスローします。したがって、正しさのためにこの例外に依存するプログラムを記述するのは間違っています。 反復子のフェイルファスト動作はバグを検出するためにのみ使用する必要があります。

Java 2 プラットフォーム v1.2 の時点で、このクラスは Map インターフェイスを実装するように改良され、そのメンバーになりました。

コレクションフレームワークをJavaします。新しいコレクションの実装とは異なり、 Hashtable は同期されます。スレッドセーフな実装が必要ない場合は、HashMapの代わりにHashtableを使用することをお勧めします。スレッドセーフな高度な同時実行実装が必要な場合は、java.util.concurrent.ConcurrentHashMapの代わりにHashtableを使用することをお勧めします。

1.0 で追加されました。

java.util.Hashtableの Java ドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

名前	説明
Hashtable()	既定の初期容量 (11) と負荷係数 (0) を使用して、新しい空のハッシュテーブルを構築します。
Hashtable(IDictionary)	指定されたマップと同じマッピングを持つ新しいハッシュテーブルを構築します。
Hashtable(Int32, Single)	指定した初期容量と指定した読み込み係数を使用して、新しい空のハッシュテーブルを構築します。
Hashtable(Int32)	指定された初期容量と既定の読み込み係数 (0) を使用して、新しい空のハッシュテーブルを構築します。
Hashtable(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

プロパティ

名前	説明
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
IsEmpty	このハッシュテーブルがキーを値にマップしていないかどうかをテストします。
JniIdentityHashCode	相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュコードを取得します。 (継承元 Object)
JniManagedPeerState	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
JniPeerMembers	このクラスは、キーを値にマップするハッシュテーブルを実装します。
PeerReference	このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

名前	説明
Clear()	キーが含まれるように、このハッシュテーブルをクリアします。
Clone()	このハッシュテーブルの簡易コピーを作成します。
Compute(Object, IBiFunction)	追加する
ComputeIfAbsent(Object, IFunction)	追加する
ComputeIfPresent(Object, IBiFunction)	追加する
Construct(JniObjectReference, JniObjectReferenceOptions)	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
Contains(Object)	一部のキーがこのハッシュテーブル内の指定された値にマップされているかどうかをテストします。
ContainsKey(Object)	指定したオブジェクトがこのハッシュテーブルのキーであるかどうかをテストします。
ContainsValue(Object)	このハッシュテーブルが 1 つ以上のキーをこの値にマップする場合は true を返します。
Dispose()	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
Dispose(Boolean)	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
DisposeUnlessReferenced()	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
Elements()	このハッシュテーブル内の値の列挙を返します。
EntrySet()	このマップに含まれるマッピングの `Set` ビューを返します。
Equals(Object)	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
ForEach(IBiConsumer)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
Get(Object)	指定したキーのマップ先の値を返します。このマップにキーのマッピングが含まれている場合は `null` します。
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
GetOrDefault(Object, Object)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
JavaFinalize()	オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Keys()	このハッシュテーブル内のキーの列挙を返します。
KeySet()	このマップに含まれるキーの `Set` ビューを返します。
Merge(Object, Object, IBiFunction)	追加する
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
Put(Object, Object)	指定した `key` を、このハッシュテーブル内の指定した `value` にマップします。
PutAll(IDictionary)	指定したマップからこのハッシュテーブルにすべてのマッピングをコピーします。
PutIfAbsent(Object, Object)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
Rehash()	エントリに対応し、より効率的にアクセスするために、このハッシュテーブルの容量を増やし、内部的に再構成します。
Remove(Object, Object)	このハッシュテーブルからキー (およびその対応する値) を削除します。
Remove(Object)	このハッシュテーブルからキー (およびその対応する値) を削除します。
Replace(Object, Object, Object)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
Replace(Object, Object)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
ReplaceAll(IBiFunction)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
Size()	このハッシュテーブル内のキーの数を返します。
ToArray<T>()	このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object)
Values()	このマップに含まれる値の `Collection` ビューを返します。
Wait()	現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)

明示的なインターフェイスの実装

名前	説明
IJavaPeerable.Disposed()	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
IJavaPeerable.Finalized()	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	このクラスは、キーを値にマップするハッシュテーブルを実装します。

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象