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 ที่แมปจากคีย์ที่ระบุ หรือค่าที่ระบุหากไม่มีการแมปดังกล่าว
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

เมธอดสาธารณะ

ต่อท้าย

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