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