SparseIntArray

public class SparseIntArray
extends Object

java.lang.Object
↳	com.android.utils.SparseIntArray

---

تُعيِّن SparseIntArrays الأعداد الصحيحة إلى الأعداد الصحيحة. وعلى عكس مصفوفة الأعداد الصحيحة العادية، يمكن أن تكون هناك فجوات في الفهارس. وهي مصمَّمة لتكون أكثر كفاءة من استخدام HashMap لربط الأعداد الصحيحة بالأعداد الصحيحة.

ملخّص

الإنشاءات العامة
SparseIntArray() تُنشئ هذه الطريقة كائن SparseIntArray جديدًا لا يحتوي على عمليات ربط.
SparseIntArray(int initialCapacity) تنشئ هذه الطريقة SparseIntArray جديدًا لا يحتوي على عمليات ربط ولن يتطلّب أي تخصيص إضافي للذاكرة لتخزين عدد عمليات الربط المحدّد.

الطُرق العامة
void	append(int key, int value) يضع زوج مفتاح/قيمة في المصفوفة، مع تحسين الحالة التي يكون فيها المفتاح أكبر من جميع المفاتيح الحالية في المصفوفة.
void	clear() يزيل هذا الإجراء جميع عمليات الربط بين المفتاح والقيمة من SparseIntArray.
void	delete(int key) يزيل هذا الإجراء عملية الربط من المفتاح المحدّد، إذا كان هناك أي ربط.
int	get(int key) تعرض هذه الدالة قيمة العدد الصحيح التي تم ربطها بالمفتاح المحدّد، أو 0 إذا لم يتم إجراء عملية الربط هذه.
int	get(int key, int valueIfKeyNotFound) تعرض هذه الطريقة العدد الصحيح الذي تم ربطه بالمفتاح المحدّد، أو القيمة المحدّدة إذا لم يتم إجراء أي ربط.
int	indexOfKey(int key) تعرض هذه الدالة الفهرس الذي تعرض الدالة keyAt(int) المفتاح المحدّد له، أو رقمًا سالبًا إذا لم يتم ربط المفتاح المحدّد.
int	indexOfValue(int value) تعرض هذه الدالة فهرسًا يعرض المفتاح المحدّد عند استخدام الدالة valueAt(int)، أو رقمًا سالبًا إذا لم يتم ربط أي مفاتيح بالقيمة المحدّدة.
int	keyAt(int index) بالنظر إلى فهرس في النطاق 0...size()-1، يعرض المفتاح من عملية الربط بين المفتاح والقيمة رقم index التي يخزّنها SparseIntArray.
void	put(int key, int value) تضيف هذه الطريقة عملية ربط من المفتاح المحدّد إلى القيمة المحدّدة، مع استبدال عملية الربط السابقة من المفتاح المحدّد إذا كانت متوفّرة.
void	removeAt(int index) يزيل عملية الربط في الفهرس المحدّد.
int	size() تعرض هذه الطريقة عدد عمليات الربط بين المفتاح والقيمة التي تخزِّنها حاليًا فئة SparseIntArray.
int	valueAt(int index) بالنظر إلى فهرس في النطاق 0...size()-1، تعرض هذه الدالة القيمة من عملية الربط بين المفتاح والقيمة رقم index التي يخزِّنها SparseIntArray.

الإنشاءات العامة

SparseIntArray

public SparseIntArray ()

تُنشئ هذه الطريقة كائن SparseIntArray جديدًا لا يحتوي على عمليات ربط.

SparseIntArray

public SparseIntArray (int initialCapacity)

تنشئ هذه الطريقة SparseIntArray جديدًا لا يحتوي على عمليات ربط ولن يتطلّب أي تخصيص إضافي للذاكرة لتخزين عدد عمليات الربط المحدّد.

المعلمات
initialCapacity	int

الطُرق العامة

append

public void append (int key, 
                int value)

يضع زوج مفتاح/قيمة في المصفوفة، مع تحسين الحالة التي يكون فيها المفتاح أكبر من جميع المفاتيح الحالية في المصفوفة.

المعلمات
key	int
value	int

محو

public void clear ()

يزيل هذا الإجراء جميع عمليات الربط بين المفتاح والقيمة من SparseIntArray.

حذف

public void delete (int key)

يزيل هذا الإجراء عملية الربط من المفتاح المحدّد، إذا كان هناك أي ربط.

المعلمات
key	int

الحصول على

public int get (int key)

تعرض هذه الدالة عددًا صحيحًا تم ربطه بالمفتاح المحدّد، أو 0 إذا لم يتم إجراء عملية الربط.

المعلمات
key	int

المرتجعات
int

الحصول على

public int get (int key, 
                int valueIfKeyNotFound)

تعرض هذه الطريقة العدد الصحيح الذي تم ربطه بالمفتاح المحدّد، أو القيمة المحدّدة إذا لم يتم إجراء أي ربط.

المعلمات
key	int
valueIfKeyNotFound	int

المرتجعات
int

indexOfKey

public int indexOfKey (int key)

تعرض هذه الدالة الفهرس الذي تعرض الدالة keyAt(int) المفتاح المحدّد له، أو رقمًا سالبًا إذا لم يتم ربط المفتاح المحدّد.

المعلمات
key	int

المرتجعات
int

indexOfValue

public int indexOfValue (int value)

تعرض هذه الدالة فهرسًا يعرض المفتاح المحدّد عند استخدام الدالة valueAt(int)، أو رقمًا سالبًا إذا لم يتم ربط أي مفاتيح بالقيمة المحدّدة. يُرجى العِلم أنّ هذا البحث خطي، على عكس عمليات البحث حسب المفتاح، وأنّه يمكن ربط مفاتيح متعددة بالقيمة نفسها، ولن يعثر هذا البحث إلا على أحدها.

المعلمات
value	int

المرتجعات
int

keyAt

public int keyAt (int index)

بالنظر إلى فهرس في النطاق 0...size()-1، يعرض المفتاح من عملية الربط بين المفتاح والقيمة رقم index التي يخزّنها SparseIntArray.

المعلمات
index	int

المرتجعات
int

وضع

public void put (int key, 
                int value)

تضيف هذه الطريقة عملية ربط من المفتاح المحدّد إلى القيمة المحدّدة، مع استبدال عملية الربط السابقة من المفتاح المحدّد إذا كانت متوفّرة.

المعلمات
key	int
value	int

removeAt

public void removeAt (int index)

يزيل عملية الربط في الفهرس المحدّد.

المعلمات
index	int

الحجم

public int size ()

تعرض هذه الطريقة عدد عمليات الربط بين المفتاح والقيمة التي تخزِّنها حاليًا فئة SparseIntArray.

المرتجعات
int

valueAt

public int valueAt (int index)

بالنظر إلى فهرس في النطاق 0...size()-1، تعرض هذه الدالة القيمة من عملية الربط بين المفتاح والقيمة رقم index التي يخزِّنها SparseIntArray.

المعلمات
index	int

المرتجعات
int