इस दस्तावेज़ में, Firebase में मौजूद डेटा की सूचियों के साथ काम करने का तरीका बताया गया है. Firebase डेटा को पढ़ने और लिखने के बारे में बुनियादी जानकारी पाने के लिए, देखें Android पर डेटा पढ़ना और लिखना लेख पढ़ें.
DatabaseReference पाना
डेटाबेस से डेटा पढ़ने और उसमें डेटा लिखने के लिए, आपको DatabaseReference का इंस्टेंस चाहिए:
Kotlin
private lateinit var database: DatabaseReference // ... database = Firebase.database.reference
Java
private DatabaseReference mDatabase; // ... mDatabase = FirebaseDatabase.getInstance().getReference();
सूचियां पढ़ना और उनमें डेटा लिखना
डेटा की सूची में डेटा जोड़ना
एक से ज़्यादा उपयोगकर्ताओं वाले ऐप्लिकेशन में, सूची में डेटा जोड़ने के लिए push() तरीके का इस्तेमाल करें.
push() तरीका, तय किए गए Firebase रेफ़रंस में हर बार नया चाइल्ड जोड़ने पर, एक यूनीक कुंजी जनरेट करता है. सूची में मौजूद हर नए एलिमेंट के लिए, अपने-आप जनरेट होने वाली इन कुंजियों का इस्तेमाल करके, कई क्लाइंट एक ही जगह पर एक ही समय में चाइल्ड जोड़ सकते हैं. इससे लिखने से जुड़ी कोई समस्या नहीं होती. push() से जनरेट होने वाली यूनीक कुंजी, टाइमस्टैंप पर आधारित होती है. इसलिए, सूची के आइटम अपने-आप क्रम से लग जाते हैं.
push() तरीके से मिले नए डेटा के रेफ़रंस का इस्तेमाल करके, चाइल्ड की अपने-आप जनरेट होने वाली कुंजी की वैल्यू पाई जा सकती है या चाइल्ड के लिए डेटा सेट किया जा सकता है. push() रेफ़रंस पर getKey() को कॉल करने पर, अपने-आप जनरेट होने वाली कुंजी की वैल्यू मिलती है.
अपने-आप जनरेट होने वाली इन कुंजियों का इस्तेमाल करके, डेटा स्ट्रक्चर को फ़्लैट किया जा सकता है. ज़्यादा जानकारी के लिए, डेटा फ़ैन-आउट उदाहरण देखें.
चाइल्ड इवेंट सुनना
सूचियों के साथ काम करते समय, आपके ऐप्लिकेशन को चाइल्ड इवेंट सुनने चाहिए. न कि सिंगल ऑब्जेक्ट के लिए इस्तेमाल किए जाने वाले वैल्यू इवेंट.
चाइल्ड इवेंट, नोड के चाइल्ड पर होने वाली खास कार्रवाइयों के जवाब में ट्रिगर होते हैं. जैसे, push() तरीके से जोड़ा गया नया चाइल्ड या updateChildren() तरीके से अपडेट किया गया चाइल्ड.
इन दोनों का इस्तेमाल, डेटाबेस में किसी खास नोड में होने वाले बदलावों को सुनने के लिए किया जा सकता है.
DatabaseReference पर चाइल्ड इवेंट सुनने के लिए, ChildEventListener जोड़ें:
| लिसनर | इवेंट कॉलबैक | आम तौर पर इस्तेमाल |
|---|---|---|
ChildEventListener
| onChildAdded() |
आइटम की सूचियां वापस पाएं या आइटम की सूची में जोड़े गए आइटम के बारे में सुनें.
यह कॉलबैक, मौजूदा हर चाइल्ड के लिए एक बार ट्रिगर होता है. इसके बाद, तय किए गए पाथ में हर बार नया चाइल्ड जोड़ने पर, यह फिर से ट्रिगर होता है.
लिसनर को पास किए गए DataSnapshot में, नए चाइल्ड का डेटा होता है.
|
onChildChanged() |
सूची में मौजूद आइटम में होने वाले बदलावों के बारे में सुनें. यह इवेंट, चाइल्ड नोड में बदलाव होने पर ट्रिगर होता है. इसमें चाइल्ड नोड के डिसेंडेंट में होने वाले बदलाव भी शामिल हैं. इवेंट लिसनर को पास किए गए DataSnapshot में, चाइल्ड के लिए अपडेट किया गया डेटा होता है.
|
|
onChildRemoved() |
सूची से हटाए जा रहे आइटम के बारे में सुनें. इवेंट कॉलबैक को पास किए गए
DataSnapshot में, हटाए गए चाइल्ड का डेटा होता है.
|
|
onChildMoved() |
क्रम से लगाई गई सूची में मौजूद आइटम के क्रम में होने वाले बदलावों के बारे में सुनें.
यह इवेंट तब ट्रिगर होता है, जब onChildChanged()
कॉलबैक, ऐसे अपडेट की वजह से ट्रिगर होता है जिससे चाइल्ड का क्रम बदल जाता है.
इसका इस्तेमाल, orderByChild या orderByValue से क्रम से लगाए गए डेटा के साथ किया जाता है.
|
उदाहरण के लिए, सोशल ब्लॉगिंग ऐप्लिकेशन, पोस्ट की टिप्पणियों में होने वाली गतिविधि की निगरानी करने के लिए, इन तरीकों का एक साथ इस्तेमाल कर सकता है. जैसा कि यहां दिखाया गया है:
Kotlin
val childEventListener = object : ChildEventListener { override fun onChildAdded(dataSnapshot: DataSnapshot, previousChildName: String?) { Log.d(TAG, "onChildAdded:" + dataSnapshot.key!!) // A new comment has been added, add it to the displayed list val comment = dataSnapshot.getValue<Comment>() // ... } override fun onChildChanged(dataSnapshot: DataSnapshot, previousChildName: String?) { Log.d(TAG, "onChildChanged: ${dataSnapshot.key}") // A comment has changed, use the key to determine if we are displaying this // comment and if so displayed the changed comment. val newComment = dataSnapshot.getValue<Comment>() val commentKey = dataSnapshot.key // ... } override fun onChildRemoved(dataSnapshot: DataSnapshot) { Log.d(TAG, "onChildRemoved:" + dataSnapshot.key!!) // A comment has changed, use the key to determine if we are displaying this // comment and if so remove it. val commentKey = dataSnapshot.key // ... } override fun onChildMoved(dataSnapshot: DataSnapshot, previousChildName: String?) { Log.d(TAG, "onChildMoved:" + dataSnapshot.key!!) // A comment has changed position, use the key to determine if we are // displaying this comment and if so move it. val movedComment = dataSnapshot.getValue<Comment>() val commentKey = dataSnapshot.key // ... } override fun onCancelled(databaseError: DatabaseError) { Log.w(TAG, "postComments:onCancelled", databaseError.toException()) Toast.makeText( context, "Failed to load comments.", Toast.LENGTH_SHORT, ).show() } } databaseReference.addChildEventListener(childEventListener)
Java
ChildEventListener childEventListener = new ChildEventListener() { @Override public void onChildAdded(DataSnapshot dataSnapshot, String previousChildName) { Log.d(TAG, "onChildAdded:" + dataSnapshot.getKey()); // A new comment has been added, add it to the displayed list Comment comment = dataSnapshot.getValue(Comment.class); // ... } @Override public void onChildChanged(DataSnapshot dataSnapshot, String previousChildName) { Log.d(TAG, "onChildChanged:" + dataSnapshot.getKey()); // A comment has changed, use the key to determine if we are displaying this // comment and if so displayed the changed comment. Comment newComment = dataSnapshot.getValue(Comment.class); String commentKey = dataSnapshot.getKey(); // ... } @Override public void onChildRemoved(DataSnapshot dataSnapshot) { Log.d(TAG, "onChildRemoved:" + dataSnapshot.getKey()); // A comment has changed, use the key to determine if we are displaying this // comment and if so remove it. String commentKey = dataSnapshot.getKey(); // ... } @Override public void onChildMoved(DataSnapshot dataSnapshot, String previousChildName) { Log.d(TAG, "onChildMoved:" + dataSnapshot.getKey()); // A comment has changed position, use the key to determine if we are // displaying this comment and if so move it. Comment movedComment = dataSnapshot.getValue(Comment.class); String commentKey = dataSnapshot.getKey(); // ... } @Override public void onCancelled(DatabaseError databaseError) { Log.w(TAG, "postComments:onCancelled", databaseError.toException()); Toast.makeText(mContext, "Failed to load comments.", Toast.LENGTH_SHORT).show(); } }; databaseReference.addChildEventListener(childEventListener);
वैल्यू इवेंट सुनना
डेटा की सूचियां पढ़ने के लिए, ChildEventListener का इस्तेमाल करने का सुझाव दिया जाता है. हालांकि, कुछ स्थितियों में सूची के रेफ़रंस में ValueEventListener जोड़ना काम का होता है.
डेटा की सूची में ValueEventListener जोड़ने पर, डेटा की पूरी सूची को एक DataSnapshot के तौर पर दिखाया जाता है. इसके बाद, अलग-अलग चाइल्ड को ऐक्सेस करने के लिए, इस पर लूप किया जा सकता है.
क्वेरी के लिए सिर्फ़ एक मैच होने पर भी, स्नैपशॉट एक सूची होती है. इसमें सिर्फ़ एक आइटम होता है. आइटम को ऐक्सेस करने के लिए, आपको नतीजे पर लूप करना होगा:
Kotlin
// My top posts by number of stars myTopPostsQuery.addValueEventListener(object : ValueEventListener { override fun onDataChange(dataSnapshot: DataSnapshot) { for (postSnapshot in dataSnapshot.children) { // TODO: handle the post } } override fun onCancelled(databaseError: DatabaseError) { // Getting Post failed, log a message Log.w(TAG, "loadPost:onCancelled", databaseError.toException()) // ... } })
Java
// My top posts by number of stars myTopPostsQuery.addValueEventListener(new ValueEventListener() { @Override public void onDataChange(@NonNull DataSnapshot dataSnapshot) { for (DataSnapshot postSnapshot: dataSnapshot.getChildren()) { // TODO: handle the post } } @Override public void onCancelled(@NonNull DatabaseError databaseError) { // Getting Post failed, log a message Log.w(TAG, "loadPost:onCancelled", databaseError.toException()); // ... } });
यह पैटर्न तब काम का हो सकता है, जब आपको onChildAdded के अतिरिक्त इवेंट सुनने के बजाय, एक ही कार्रवाई में सूची के सभी चाइल्ड को फ़ेच करना हो.
लिसनर हटाना
कॉलबैक हटाने के लिए, Firebase डेटाबेस रेफ़रंस पर removeEventListener() तरीका कॉल करें.
अगर किसी डेटा की जगह पर कोई लिसनर एक से ज़्यादा बार जोड़ा गया है, तो हर इवेंट के लिए उसे एक से ज़्यादा बार कॉल किया जाता है. इसे पूरी तरह से हटाने के लिए, आपको इसे उतनी ही बार हटाना होगा.
पैरंट लिसनर पर removeEventListener() को कॉल करने से, उसके चाइल्ड नोड पर रजिस्टर किए गए लिसनर अपने-आप नहीं हटते. कॉलबैक हटाने के लिए, चाइल्ड लिसनर पर भी removeEventListener() को कॉल करना ज़रूरी है.
डेटा को क्रम से लगाना और फ़िल्टर करना
कुंजी, वैल्यू या चाइल्ड की वैल्यू के हिसाब से क्रम से लगाया गया डेटा वापस पाने के लिए, Realtime Database Query क्लास का इस्तेमाल किया जा सकता है. क्रम से लगाए गए नतीजों को, नतीजों की तय संख्या या कुंजियों या वैल्यू की किसी रेंज के हिसाब से फ़िल्टर भी किया जा सकता है.
डेटा को क्रम से लगाना
क्रम से लगाया गया डेटा वापस पाने के लिए, सबसे पहले क्रम से लगाने के किसी एक तरीके को तय करें. इससे यह तय किया जा सकेगा कि नतीजों को किस क्रम में लगाया जाए:
| तरीका | इस्तेमाल |
|---|---|
orderByChild() |
नतीजों को, तय की गई चाइल्ड कुंजी या नेस्ट किए गए चाइल्ड पाथ की वैल्यू के हिसाब से क्रम से लगाएं. |
orderByKey()
| नतीजों को चाइल्ड कुंजियों के हिसाब से क्रम से लगाएं. |
orderByValue() |
नतीजों को चाइल्ड वैल्यू के हिसाब से क्रम से लगाएं. |
एक बार में, क्रम से लगाने का सिर्फ़ एक तरीका इस्तेमाल किया जा सकता है. एक ही क्वेरी में, क्रम से लगाने के किसी तरीके को एक से ज़्यादा बार कॉल करने पर, गड़बड़ी होती है.
यहां दिए गए उदाहरण में बताया गया है कि किसी उपयोगकर्ता की सबसे लोकप्रिय पोस्ट की सूची को, उन्हें मिले स्टार की संख्या के हिसाब से क्रम से कैसे लगाया जा सकता है:
Kotlin
// My top posts by number of stars val myUserId = uid val myTopPostsQuery = databaseReference.child("user-posts").child(myUserId) .orderByChild("starCount") myTopPostsQuery.addChildEventListener(object : ChildEventListener { // TODO: implement the ChildEventListener methods as documented above // ... })
Java
// My top posts by number of stars String myUserId = getUid(); Query myTopPostsQuery = databaseReference.child("user-posts").child(myUserId) .orderByChild("starCount"); myTopPostsQuery.addChildEventListener(new ChildEventListener() { // TODO: implement the ChildEventListener methods as documented above // ... });
इससे एक क्वेरी तय होती है. जब इसे चाइल्ड लिसनर के साथ जोड़ा जाता है, तो यह क्लाइंट को डेटाबेस में उपयोगकर्ता की पोस्ट के साथ सिंक करती है . यह पोस्ट, उपयोगकर्ता की आईडी के आधार पर, डेटाबेस में तय किए गए पाथ से ली जाती हैं. साथ ही, इन्हें हर पोस्ट को मिले स्टार की संख्या के हिसाब से क्रम से लगाया जाता है. आईडी को इंडेक्स कुंजियों के तौर पर इस्तेमाल करने की इस तकनीक को डेटा फ़ैन आउट कहा जाता है. इसके बारे में ज़्यादा जानने के लिए, डेटाबेस का स्ट्रक्चर बनाना लेख पढ़ें.
orderByChild() तरीके को कॉल करने पर, उस चाइल्ड कुंजी को तय किया जाता है जिसके हिसाब से नतीजों को क्रम से लगाना है. इस मामले में, पोस्ट को उनके संबंधित
"starCount" चाइल्ड की वैल्यू के हिसाब से क्रम से लगाया जाता है. क्वेरी को नेस्ट किए गए चाइल्ड के हिसाब से भी क्रम से लगाया जा सकता है. ऐसा तब किया जा सकता है, जब आपके पास इस तरह का डेटा हो:
"posts": {
"ts-functions": {
"metrics": {
"views" : 1200000,
"likes" : 251000,
"shares": 1200,
},
"title" : "Why you should use TypeScript for writing Cloud Functions",
"author": "Doug",
},
"android-arch-3": {
"metrics": {
"views" : 900000,
"likes" : 117000,
"shares": 144,
},
"title" : "Using Android Architecture Components with Firebase Realtime Database (Part 3)",
"author": "Doug",
}
},इस उदाहरण में, हम अपनी सूची के एलिमेंट को metrics कुंजी के तहत नेस्ट की गई वैल्यू के हिसाब से क्रम से लगा सकते हैं. इसके लिए, orderByChild() कॉल में नेस्ट किए गए चाइल्ड का रिलेटिव पाथ तय करें.
Kotlin
// Most viewed posts val myMostViewedPostsQuery = databaseReference.child("posts") .orderByChild("metrics/views") myMostViewedPostsQuery.addChildEventListener(object : ChildEventListener { // TODO: implement the ChildEventListener methods as documented above // ... })
Java
// Most viewed posts Query myMostViewedPostsQuery = databaseReference.child("posts") .orderByChild("metrics/views"); myMostViewedPostsQuery.addChildEventListener(new ChildEventListener() { // TODO: implement the ChildEventListener methods as documented above // ... });
अन्य डेटा टाइप को क्रम से लगाने के तरीके के बारे में ज़्यादा जानने के लिए, क्वेरी के डेटा को क्रम से कैसे लगाया जाता है लेख पढ़ें.
डेटा फ़िल्टर करना
डेटा को फ़िल्टर करने के लिए, क्वेरी बनाते समय, सीमा या रेंज के किसी भी तरीके को क्रम से लगाने के किसी तरीके के साथ जोड़ा जा सकता है.
| तरीका | इस्तेमाल |
|---|---|
limitToFirst() |
नतीजों की क्रम से लगाई गई सूची की शुरुआत से, वापस पाने के लिए आइटम की ज़्यादा से ज़्यादा संख्या सेट करता है. |
limitToLast() |
नतीजों की क्रम से लगाई गई सूची के आखिर से, वापस पाने के लिए आइटम की ज़्यादा से ज़्यादा संख्या सेट करता है. |
startAt() |
क्रम से लगाने के चुने गए तरीके के आधार पर, तय की गई कुंजी या वैल्यू से ज़्यादा या उसके बराबर वाले आइटम वापस पाएं. |
startAfter() |
क्रम से लगाने के चुने गए तरीके के आधार पर, तय की गई कुंजी या वैल्यू से ज़्यादा वाले आइटम वापस पाएं. |
endAt() |
क्रम से लगाने के चुने गए तरीके के आधार पर, तय की गई कुंजी या वैल्यू से कम या उसके बराबर वाले आइटम वापस पाएं. |
endBefore() |
क्रम से लगाने के चुने गए तरीके के आधार पर, तय की गई कुंजी या वैल्यू से कम वाले आइटम वापस पाएं. |
equalTo() |
क्रम से लगाने के चुने गए तरीके के आधार पर, तय की गई कुंजी या वैल्यू के बराबर वाले आइटम वापस पाएं. |
क्रम से लगाने के तरीकों के उलट, सीमा या रेंज के कई फ़ंक्शन को जोड़ा जा सकता है.
उदाहरण के लिए, नतीजों को वैल्यू की तय की गई रेंज तक सीमित करने के लिए, startAt() और endAt() तरीकों को जोड़ा जा सकता है.
क्वेरी के लिए सिर्फ़ एक मैच होने पर भी, स्नैपशॉट एक सूची होती है. इसमें सिर्फ़ एक आइटम होता है. आइटम को ऐक्सेस करने के लिए, आपको नतीजे पर लूप करना होगा:
Kotlin
// My top posts by number of stars myTopPostsQuery.addValueEventListener(object : ValueEventListener { override fun onDataChange(dataSnapshot: DataSnapshot) { for (postSnapshot in dataSnapshot.children) { // TODO: handle the post } } override fun onCancelled(databaseError: DatabaseError) { // Getting Post failed, log a message Log.w(TAG, "loadPost:onCancelled", databaseError.toException()) // ... } })
Java
// My top posts by number of stars myTopPostsQuery.addValueEventListener(new ValueEventListener() { @Override public void onDataChange(@NonNull DataSnapshot dataSnapshot) { for (DataSnapshot postSnapshot: dataSnapshot.getChildren()) { // TODO: handle the post } } @Override public void onCancelled(@NonNull DatabaseError databaseError) { // Getting Post failed, log a message Log.w(TAG, "loadPost:onCancelled", databaseError.toException()); // ... } });
नतीजों की संख्या सीमित करना
limitToFirst() और limitToLast() तरीकों का इस्तेमाल करके, किसी दिए गए कॉलबैक के लिए सिंक किए जाने वाले चाइल्ड की ज़्यादा से ज़्यादा संख्या सेट की जा सकती है. उदाहरण के लिए, अगर limitToFirst() का इस्तेमाल करके 100 की सीमा सेट की जाती है, तो आपको शुरुआती तौर पर सिर्फ़ 100 onChildAdded() कॉलबैक मिलते हैं. अगर आपके Firebase डेटाबेस में 100 से कम आइटम सेव हैं, तो हर आइटम के लिए एक onChildAdded() कॉलबैक ट्रिगर होता है.
आइटम में बदलाव होने पर, आपको उन आइटम के लिए onChildAdded() कॉलबैक मिलते हैं जो क्वेरी में शामिल होते हैं. साथ ही, उन आइटम के लिए onChildRemoved() कॉलबैक मिलते हैं जो क्वेरी से हट जाते हैं. इससे आइटम की कुल संख्या 100 बनी रहती है.
यहां दिए गए उदाहरण में, ब्लॉगिंग ऐप्लिकेशन, सभी उपयोगकर्ताओं की सबसे नई 100 पोस्ट की सूची वापस पाने के लिए, क्वेरी को कैसे तय करता है, यह दिखाया गया है:
Kotlin
// Last 100 posts, these are automatically the 100 most recent // due to sorting by push() keys. databaseReference.child("posts").limitToFirst(100)
Java
// Last 100 posts, these are automatically the 100 most recent // due to sorting by push() keys Query recentPostsQuery = databaseReference.child("posts") .limitToFirst(100);
कुंजी या वैल्यू के हिसाब से फ़िल्टर करना
क्वेरी के लिए, शुरुआती, खत्म होने वाले, और समानता वाले पॉइंट तय करने के लिए, startAt(), startAfter(), endAt(), endBefore(), और equalTo() का इस्तेमाल किया जा सकता है. यह डेटा को पेज में बांटने या ऐसे आइटम ढूंढने के लिए काम का हो सकता है जिनके चाइल्ड की कोई खास वैल्यू हो.
क्वेरी के डेटा को क्रम से कैसे लगाया जाता है
इस सेक्शन में बताया गया है कि Query क्लास में, क्रम से लगाने के हर तरीके से डेटा को कैसे क्रम से लगाया जाता है.
orderByChild
orderByChild() का इस्तेमाल करने पर, तय की गई चाइल्ड कुंजी वाला डेटा इस तरह क्रम से लगाया जाता है:
- तय की गई चाइल्ड कुंजी के लिए,
nullवैल्यू वाले चाइल्ड सबसे पहले आते हैं. - तय की गई चाइल्ड कुंजी के लिए,
falseवैल्यू वाले चाइल्ड इसके बाद आते हैं. अगर कई चाइल्ड की वैल्यूfalseहै, तो उन्हें कुंजी के हिसाब से लेक्सिकोग्राफ़िक क्रम में लगाया जाता है. - तय की गई चाइल्ड कुंजी के लिए,
trueवैल्यू वाले चाइल्ड इसके बाद आते हैं. अगर कई चाइल्ड की वैल्यूtrueहै, तो उन्हें कुंजी के हिसाब से लेक्सिकोग्राफ़िक क्रम में लगाया जाता है. - इसके बाद, संख्या वाली वैल्यू वाले चाइल्ड आते हैं. इन्हें बढ़ते क्रम में लगाया जाता है. अगर तय किए गए चाइल्ड नोड के लिए, कई चाइल्ड की संख्या वाली वैल्यू एक जैसी है, तो उन्हें कुंजी के हिसाब से क्रम से लगाया जाता है.
- स्ट्रिंग, संख्याओं के बाद आती हैं. इन्हें बढ़ते क्रम में लेक्सिकोग्राफ़िक क्रम में लगाया जाता है . अगर तय किए गए चाइल्ड नोड के लिए, कई चाइल्ड की वैल्यू एक जैसी है, तो उन्हें कुंजी के हिसाब से लेक्सिकोग्राफ़िक क्रम में लगाया जाता है.
- ऑब्जेक्ट सबसे आखिर में आते हैं. इन्हें बढ़ते क्रम में कुंजी के हिसाब से लेक्सिकोग्राफ़िक क्रम में लगाया जाता है.
orderByKey
अपने डेटा को क्रम से लगाने के लिए, orderByKey() का इस्तेमाल करने पर, डेटा को कुंजी के हिसाब से बढ़ते क्रम में दिखाया जाता है.
- ऐसी कुंजी वाले चाइल्ड सबसे पहले आते हैं जिन्हें 32-बिट इंटिजर के तौर पर पार्स किया जा सकता है. इन्हें बढ़ते क्रम में लगाया जाता है.
- इसके बाद, ऐसी स्ट्रिंग वैल्यू वाले चाइल्ड आते हैं जिनकी कुंजी के तौर पर इस्तेमाल किया जाता है. इन्हें बढ़ते क्रम में लेक्सिकोग्राफ़िक क्रम में लगाया जाता है.
orderByValue
orderByValue() का इस्तेमाल करने पर, चाइल्ड को उनकी वैल्यू के हिसाब से क्रम से लगाया जाता है. क्रम से लगाने के मानदंड, orderByChild() में इस्तेमाल किए जाने वाले मानदंडों के जैसे ही होते हैं. हालांकि, इसमें तय की गई चाइल्ड कुंजी की वैल्यू के बजाय, नोड की वैल्यू का इस्तेमाल किया जाता है.