SparseArray クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SparseArray は整数を Objects にマップし、オブジェクトの通常の配列とは異なり、そのインデックスにはギャップを含めることができます。
[Android.Runtime.Register("android/util/SparseArray", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class SparseArray : Java.Lang.Object, IDisposable, Java.Lang.ICloneable[<Android.Runtime.Register("android/util/SparseArray", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type SparseArray = class
inherit Object
interface ICloneable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 継承
- 派生
- 属性
- 実装
注釈
SparseArray は整数を Objects にマップし、オブジェクトの通常の配列とは異なり、そのインデックスにはギャップを含めることができます。
SparseArray は、 <c>HashMap</c> よりもメモリ効率が向上することを目的としています。これは、自動ボックス化キーを回避し、そのデータ構造がマッピングごとに追加のエントリ オブジェクトに依存しないためです。
このコンテナーでは、バイナリ検索を使用してキーを検索し、そのマッピングを配列データ構造に保持することに注意してください。 この実装は、多数の項目を含む可能性があるデータ構造に適したものではありません。 一般に、ルックアップにはバイナリ検索が必要であり、追加と削除には配列内のエントリの挿入と削除が必要になるため、 HashMap よりも遅くなります。 数百の項目を保持するコンテナーの場合、パフォーマンスの違いは 50%未満です。
パフォーマンスを向上させるために、コンテナーにはキーを削除するときの最適化が含まれています。配列をすぐに圧縮する代わりに、削除されたエントリは削除済みとしてマークされた状態になります。 その後、同じキーに対してエントリを再利用するか、削除されたすべてのエントリの 1 つのガベージ コレクションで後で圧縮できます。 このガベージ コレクションは、配列を拡大する必要がある場合、またはマップ のサイズまたはエントリ値が取得されるたびに実行する必要があります。
#keyAt(int)と#valueAt(int)を使用して、このコンテナー内の項目を反復処理できます。 インデックスの昇順の値を持つ keyAt(int) を使用してキーを反復処理すると、キーが昇順で返されます。
valueAt(int)の場合、キーに対応する値は昇順で返されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| 名前 | 説明 |
|---|---|
| SparseArray() |
マッピングを含まない新しい SparseArray を作成します。 |
| SparseArray(Int32) |
指定した数のマッピングを格納するために追加のメモリ割り当てを必要としないマッピングを含まない新しい SparseArray を作成します。 |
| SparseArray(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Class |
この |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| JniIdentityHashCode |
相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| PeerReference |
このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object) |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
メソッド
| 名前 | 説明 |
|---|---|
| Append(Int32, Object) |
キーと値のペアを配列に格納し、キーが配列内のすべての既存のキーより大きい場合に最適化します。 |
| Clear() |
この SparseArray からすべてのキーと値のマッピングを削除します。 |
| Clone() |
この |
| Compute(Int32, IIntObjFunction) |
現在のマッピング (現在のマッピングがない場合は null) に基づいて、指定したキーの新しいマップされた値の計算を試みます。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Contains(Int32) |
配列にキーが存在する場合は true を返します。 |
| ContentEquals(SparseArray) |
この |
| ContentHashCode() |
この |
| Delete(Int32) |
指定したキー (存在する場合) からマッピングを削除します。 |
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| Get(Int32, Object) |
指定したキーからマップされたオブジェクトを取得します。そのようなマッピングが行われなかった場合は、指定したオブジェクトを取得します。 |
| Get(Int32) |
指定したキーからマップされたオブジェクトを取得します。そのようなマッピングが行われなかった場合は |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| IndexOfKey(Int32) |
|
| IndexOfValue(Object) |
|
| JavaFinalize() |
古い.
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| KeyAt(Int32) |
|
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| Put(Int32, Object) |
指定したキーから指定した値にマッピングを追加し、指定したキーの前のマッピングが存在する場合は置き換えます。 |
| Remove(Int32) |
|
| RemoveAt(Int32) |
指定したインデックス位置にあるマッピングを削除します。 |
| RemoveAtRange(Int32, Int32) |
バッチとしてマッピングの範囲を削除します。 |
| Set(Int32, Object) |
Kotlin [index]= 演算子をサポートする |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| SetValueAt(Int32, Object) |
|
| Size() |
この SparseArray が現在格納しているキーと値のマッピングの数を返します。 |
| ToArray<T>() |
このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object) |
| ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object) |
| ValueAt(Int32) |
|
| 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() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|