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 रेंज में इंडेक्स दिए जाने पर, यह SparseIntArray में सेव किए गए index वें की-वैल्यू मैपिंग से कुंजी दिखाता है.
void	put(int key, int value) यह फ़ंक्शन, दी गई कुंजी को दी गई वैल्यू से मैप करता है. अगर दी गई कुंजी पहले से किसी वैल्यू से मैप है, तो यह फ़ंक्शन उस मैपिंग को बदल देता है.
void	removeAt(int index) यह दिए गए इंडेक्स पर मौजूद मैपिंग को हटाता है.
int	size() यह फ़ंक्शन, इस SparseIntArray में मौजूद कुंजी-वैल्यू मैपिंग की संख्या दिखाता है.
int	valueAt(int index) 0...size()-1 रेंज में इंडेक्स दिए जाने पर, यह SparseIntArray में सेव किए गए index वें कुंजी-वैल्यू मैपिंग की वैल्यू दिखाता है.

पब्लिक कंस्ट्रक्टर

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 रेंज में इंडेक्स दिए जाने पर, यह SparseIntArray में सेव किए गए index वें की-वैल्यू मैपिंग से कुंजी दिखाता है.

पैरामीटर
index	int

रिटर्न
int

रखें

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 रेंज में इंडेक्स दिए जाने पर, यह SparseIntArray में सेव किए गए index वें कुंजी-वैल्यू मैपिंग की वैल्यू दिखाता है.

पैरामीटर
index	int

रिटर्न
int