SparseIntArray

public class SparseIntArray
extends Object

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


ב-SparseIntArrays, המספרים השלמים ממופים למספרים שלמים. בניגוד למערך רגיל של מספרים שלמים, יכולים להיות פערים במדדים. היא נועדה להיות יעילה יותר משימוש ב-HashMap למיפוי מספרים שלמים למספרים שלמים.

סיכום

Constructors ציבוריים

SparseIntArray()

יוצרת SparseIntArray חדש שלא מכיל מיפויים.

SparseIntArray(int initialCapacity)

יוצר SparseIntArray חדש שלא מכיל מיפויים, ולא נדרשת הקצאת זיכרון נוספת כדי לאחסן את מספר המיפויים שצוין.

‫methods ציבוריים

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 הזה.

Constructors ציבוריים

SparseIntArray

public SparseIntArray ()

יוצרת SparseIntArray חדש שלא מכיל מיפויים.

SparseIntArray

public SparseIntArray (int initialCapacity)

יוצר SparseIntArray חדש שלא מכיל מיפויים, ולא נדרשת הקצאת זיכרון נוספת כדי לאחסן את מספר המיפויים שצוין.

פרמטרים
initialCapacity int

‫methods ציבוריים

פעולת append

public void append (int key, 
                int value)

הפונקציה מכניסה צמד מפתח/ערך למערך, ומבצעת אופטימיזציה למקרה שבו המפתח גדול מכל המפתחות הקיימים במערך.

פרמטרים
key int

value int

מחיקה

public void clear ()

הפעולה הזו מסירה את כל המיפויים של צמדי מפתח/ערך מ-SparseIntArray.

מחק

public void delete (int key)

מסירה את המיפוי מהמפתח שצוין, אם היה מיפוי כזה.

פרמטרים
key int

get

public int get (int key)

מחזירה את הערך המספרי שמופה מהמפתח שצוין, או 0 אם לא בוצע מיפוי כזה.

פרמטרים
key int

החזרות
int

get

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

put

public void put (int key, 
                int value)

הפעולה מוסיפה מיפוי מהמפתח שצוין לערך שצוין, ומחליפה את המיפוי הקודם מהמפתח שצוין אם היה כזה.

פרמטרים
key int

value int

removeAt

public void removeAt (int index)

מסירה את המיפוי באינדקס הנתון.

פרמטרים
index int

size

public int size ()

הפונקציה מחזירה את מספר המיפויים של זוגות מפתח/ערך שמאוחסנים כרגע ב-SparseIntArray הזה.

החזרות
int

valueAt

public int valueAt (int index)

בהינתן אינדקס בטווח 0...size()-1, הפונקציה מחזירה את הערך ממיפוי המפתח-ערך ה-index שמאוחסן ב-SparseIntArray הזה.

פרמטרים
index int

החזרות
int