اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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`