آرایه پراکنده

public class SparseIntArray
extends 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)

عدد صحیح (int) نگاشت شده از کلید مشخص شده را برمی‌گرداند، یا اگر چنین نگاشتی انجام نشده باشد، 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 th نگاشت کلید-مقدار که این SparseIntArray ذخیره می‌کند، برمی‌گرداند.

void put (int key, int value)

یک نگاشت از کلید مشخص شده به مقدار مشخص شده اضافه می‌کند و در صورت وجود، آن را جایگزین نگاشت قبلی از کلید مشخص شده می‌کند.

void removeAt (int index)

نگاشت را در اندیس داده شده حذف می‌کند.

int size ()

تعداد نگاشت‌های کلید-مقدار که این SparseIntArray در حال حاضر ذخیره می‌کند را برمی‌گرداند.

int valueAt (int index)

با توجه به یک اندیس در محدوده 0...size()-1 ، مقداری را از index نگاشت کلید-مقدار که این SparseIntArray ذخیره می‌کند، برمی‌گرداند.

سازندگان عمومی

آرایه پراکنده 

public SparseIntArray ()

یک SparseIntArray جدید ایجاد می‌کند که حاوی هیچ نگاشتی نیست.

آرایه پراکنده 

public SparseIntArray (int initialCapacity)

یک SparseIntArray جدید ایجاد می‌کند که حاوی هیچ نگاشتی نیست و برای ذخیره تعداد مشخص‌شده از نگاشت‌ها به هیچ تخصیص حافظه اضافی نیاز نخواهد داشت.

پارامترها
initialCapacity int

روش‌های عمومی

ضمیمه کردن 

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)

عدد صحیح (int) نگاشت شده از کلید مشخص شده را برمی‌گرداند، یا اگر چنین نگاشتی انجام نشده باشد، 0 برمی‌گرداند.

پارامترها
key int

بازگشت‌ها
int

دریافت 

public int get (int key, 
                int valueIfKeyNotFound)

عدد صحیح نگاشت شده از کلید مشخص شده، یا مقدار مشخص شده را در صورتی که چنین نگاشتی انجام نشده باشد، برمی‌گرداند.

پارامترها
key int

valueIfKeyNotFound int

بازگشت‌ها
int

شاخص کلید 

public int indexOfKey (int key)

اندیسی را برمی‌گرداند که keyAt(int) برای آن، کلید مشخص شده را برمی‌گرداند، یا اگر کلید مشخص شده نگاشت نشده باشد، یک عدد منفی برمی‌گرداند.

پارامترها
key int

بازگشت‌ها
int

شاخص ارزش 

public int indexOfValue (int value)

یک اندیس برمی‌گرداند که valueAt(int) برای آن کلید مشخص شده را برمی‌گرداند، یا اگر هیچ کلیدی به مقدار مشخص شده نگاشت نشده باشد، یک عدد منفی برمی‌گرداند. توجه داشته باشید که این یک جستجوی خطی است، برخلاف جستجو بر اساس کلید، و چندین کلید می‌توانند به یک مقدار نگاشت شوند و این فقط یکی از آنها را پیدا می‌کند.

پارامترها
value int

بازگشت‌ها
int

کلید 

public int keyAt (int index)

با توجه به یک اندیس در محدوده 0...size()-1 ، کلید را از index th نگاشت کلید-مقدار که این SparseIntArray ذخیره می‌کند، برمی‌گرداند.

پارامترها
index int

بازگشت‌ها
int

قرار دادن 

public void put (int key, 
                int value)

یک نگاشت از کلید مشخص شده به مقدار مشخص شده اضافه می‌کند و در صورت وجود، آن را جایگزین نگاشت قبلی از کلید مشخص شده می‌کند.

پارامترها
key int

value int

حذف 

public void removeAt (int index)

نگاشت را در اندیس داده شده حذف می‌کند.

پارامترها
index int

اندازه 

public int size ()

تعداد نگاشت‌های کلید-مقدار که این SparseIntArray در حال حاضر ذخیره می‌کند را برمی‌گرداند.

بازگشت‌ها
int

ارزش در 

public int valueAt (int index)

با توجه به یک اندیس در محدوده 0...size()-1 ، مقداری را از index نگاشت کلید-مقدار که این SparseIntArray ذخیره می‌کند، برمی‌گرداند.

پارامترها
index int

بازگشت‌ها
int