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.Interop.IJavaPeerable, 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

Object

Dictionary
Hashtable

属性: RegisterAttribute JavaTypeParametersAttribute

実装: IJavaObject IJavaPeerable ISerializable ICloneable IMap IDisposable

注釈

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

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

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

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

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

多数のエントリを作成 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返される反復子は、"fail-fast</em>" です<>。反復子の作成後にいつでも Hashtable が構造的に変更される場合、反復子の独自removeのメソッドを介した場合を除き、反復子によってスローConcurrentModificationExceptionされます。したがって、同時変更が発生した場合、反復子は、将来不確定な時点で任意の非決定論的な動作を危険にさらすのではなく、迅速かつクリーンに失敗します。 Hashtable #keys keys によって返される列挙型と#elements elementsメソッドは<、失敗>しても失敗しません<>。列挙が作成された後にいつでも Hashtable が構造的に変更された場合、列挙の結果は未定義になります。

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

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

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

1.0 で追加されました。

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

このページの一部は、Android オープンソースプロジェクトによって作成および共有され、クリエイティブコモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

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

プロパティ

Class	この `Object`ランタイムクラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
IsEmpty	このハッシュテーブルがキーを値にマップしていないかどうかをテストします。
JniIdentityHashCode	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 Object)
JniPeerMembers	このクラスは、キーを値にマップするハッシュテーブルを実装します。
PeerReference	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

Clear()	キーが含まれるように、このハッシュテーブルをクリアします。
Clone()	このハッシュテーブルの簡易コピーを作成します。
Compute(Object, IBiFunction)	追加する
ComputeIfAbsent(Object, IFunction)	追加する
ComputeIfPresent(Object, IBiFunction)	追加する
Contains(Object)	一部のキーがこのハッシュテーブル内の指定された値にマップされているかどうかをテストします。
ContainsKey(Object)	指定したオブジェクトがこのハッシュテーブルのキーであるかどうかをテストします。
ContainsValue(Object)	このハッシュテーブルが 1 つ以上のキーをこの値にマップする場合は true を返します。
Dispose()	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 Object)
Dispose(Boolean)	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 Object)
Elements()	このハッシュテーブル内の値の列挙を返します。
EntrySet()	このマップに `Set` 含まれるマッピングのビューを返します。
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)	このハッシュテーブルからキー (およびその対応する値) を削除します。
Remove(Object, Object)	このハッシュテーブルからキー (およびその対応する値) を削除します。
Replace(Object, Object)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
Replace(Object, Object, Object)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
ReplaceAll(IBiFunction)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
Size()	このハッシュテーブル内のキーの数を返します。
ToArray<T>()	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 Object)
ToString()	オブジェクトの文字列表現を返します。 (継承元 Object)
UnregisterFromRuntime()	このクラスは、キーを値にマップするハッシュテーブルを実装します。 (継承元 Object)
Values()	このマップに `Collection` 含まれる値のビューを返します。
Wait()	現在のスレッドが目覚めるまで待機させます。通常<は、通知<>/em> または <em>割り込み/em> を受け<取ります。 (継承元 Object)
Wait(Int64)	現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)

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

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

拡張メソッド

JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	このクラスは、キーを値にマップするハッシュテーブルを実装します。
GetJniTypeName(IJavaPeerable)	このクラスは、キーを値にマップするハッシュテーブルを実装します。

適用対象