XML DOM XPathResult वस्तु
- पिछला पृष्ठ DOM XPathExpression
- अगला पृष्ठ DOM XSLTProcessor
XPath क्वेरी का परिणाम
XPathResult ऑब्जैक्ट
XPathResult ऑब्जैक्ट एक XPath एक्सप्रेशन के मूल्य को प्रतिनिधित्व करता है। इस तरह के ऑब्जैक्ट Document.evaluate() और XPathExpression.evaluate() वापसी। XPath क्वेरी को स्ट्रिंग, संख्या, बूल वैल्यू, नोड और नोड की सूची के रूप में गिना सकता है। XPath अनुप्रयोग की सूची को कई तरीकों से वापस किया जा सकता है, इसलिए इस ऑब्जैक्ट को XPath क्वेरी के वास्तविक परिणाम प्राप्त करने के लिए एक बहुत सरल API के रूप में परिभाषित किया गया है।
एक XPathResult का उपयोग करने के लिए, पहले resultType अटिब्यूट की जाँच करें।यह अटिब्यूट एक XPathResult स्थिरांक सहेजता है।इस अटिब्यूट के मान को जानकर आप जिस अटिब्यूट और मेथड को उपयोग करना चाहते हैं इसे निर्धारित करें।इसके लिए निर्धारित नहीं किए गए resultType के मेथड को बुलाना या इसके लिए निर्धारित नहीं किए गए अटिब्यूट को पढ़ना असफलता पैदा करेगा।
IE XPathResult API का समर्थन नहीं करता।IE में XPath छानने के लिए, Node.selectNodes() और Node.selectSingleNode() .
XPathResult ऑब्जेक्ट के स्थिरांक
निम्नलिखित स्थिरांक एक XPath छानने की पछाड़ी के संभावित परिणाम क़िस्म को परिभाषित करते हैं।XPathResult ऑब्जेक्ट के resultType अटिब्यूट इन मानों में से एक को सहेजता है, जिससे ऑब्जेक्ट किस परिणाम क़िस्म को सहेजता है इसे निर्धारित करता है।इन स्थिरांकों को Document.evaluate() और XPathExpression.evaluate() के साथ साथ प्रयोग किया जाता है, ताकि आशा की जाने वाली परिणाम क़िस्म को निर्धारित किया जा सके।
इन स्थिरांकों और उनके अर्थ निम्नलिखित हैं:
- ANY_TYPE
- इस मान को Document.evaluate() या XPathExpression.evaluate() को पास करके विशेष परिणाम क़िस्म निर्धारित करने के लिए पास करें।अटिब्यूट resultType इस मान को नहीं सेट करता है।
- NUMBER_TYPE
- numbervalue परिणाम सहेजता है।
- STRING_TYPE
- stringvalue परिणाम सहेजता है।
- BOOLEAN_TYPE
- booleanValue परिणाम सहेजता है।
- UNORDERED_NODE_ITERATOR_TYPE
- यह परिणाम नोड के अनवरण संग्रह है, iterateNext() को दोहराकर null वापस करने तक इसे एक-एक के रूप में एक्सेस किया जा सकता है।इस इटरेशन के दौरान दस्तावेज़ को संशोधित नहीं किया जाना चाहिए।
- ORDERED_NODE_ITERATOR_TYPE
- परिणाम क्षेत्र की सूची है, जो दस्तावेज़ में अटिब्यूट के क्रम में रखा गया है, iterateNext() को दोहराकर null वापस करने तक इसे एक-एक के रूप में एक्सेस किया जा सकता है।इस इटरेशन के दौरान दस्तावेज़ को संशोधित नहीं किया जाना चाहिए।
- UNORDERED_NODE_SNAPSHOT_TYPE
- परिणाम एक रैंडॉम एक्सेस क्षेत्रों की सूची है।snapshotLength अटिब्यूट सूची की लंबाई निर्धारित करता है और snapshotItem() मेथड निर्धारित इंडेक्स के क्षेत्र को वापस करता है।क्षेत्र उसके दस्तावेज़ में दिखाई देने की क्रमवार्ता से अलग हो सकता है।इस परिणाम को 'स्नैपशॉट' कहा जाता है, इसलिए यदि दस्तावेज़ पर परिवर्तन होता है तो भी इसका उपयोग किया जा सकता है।
- ORDERED_NODE_SNAPSHOT_TYPE
- यह परिणाम एक रांधी नोड सूची है, जैसा कि UNORDERED_NODE_SNAPSHOT_TYPE, लेकिन यह सूची दस्तावेज़ में क्रम के अनुसार व्यवस्थित है।
- ANY_UNORDERED_NODE_TYPE
- singleNodeValue गुण को खोज से मेल खाने वाले एक नोड को संदर्भित करता है, अगर कोई मेल नहीं होता है, तो null होगा। अगर कई नोड खोज से मेल खाते हैं, singleNodeValue कोई भी मेल खाने वाला नोड हो सकता है।
- FIRST_ORDERED_NODE_TYPE
- singleNodeValue दस्तावेज़ में पहले से ही प्रथम जो खोज जुड़े नोड को सहेजता है, अगर कोई मेल नहीं होता है, तो null होगा।
XPathResult ऑब्जेक्ट के इंस्टेंस गुण
यहाँ के कई गुण केवल तभी प्रभावी होते हैं जब resultType एक विशेष मूल्य सहेजा है। वर्तमान resultType के लिए निर्धारित नहीं होने वाले गुणों को देखने से अस्तित्वविरोधी अवगमन हो सकता है।
- booleanValue
- जब resultType BOOLEAN_TYPE हो तो, परिणाम मूल्य को सहेजें।
- invalidIteratorState
- यदि resultType ITERATOR_TYPE अक्षरों में से एक है और दस्तावेज़ परिवर्तित हो चुका है, तो true होगा; यह इटरेटर अवैध हो जाता है क्योंकि परिणाम पहले से ही वापसी प्राप्त कर लिया है।
- numberValue
- जब resultType NUMBER_TYPE हो तो, परिणाम मूल्य को सहेजें।
- resultType
- XPath के द्वारा क्या परिणाम मिलेगा। इसका मूल्य पहले सूचीबद्ध आम शब्दों में से एक है। इस गुण के मूल्य से पता चलता है कि आप कौन-से अन्य गुण और विधियों को इस्तेमाल कर सकते हैं।
- singleNodeValue
- जब resultType XPathResult.ANY_UNORDERED_NODE_TYPE या XPathResult.FIRST_UNORDERED_NODE_TYPE हो तो, परिणाम मूल्य को सहेजें।
- snapshotLength
- जब resultType यहाँ UNORDERED_NODE_SNAPSHOT_TYPE या ORDERED_NODE_ITERATOR_TYPE हो तो, वापसी वाले नोड की संख्या निर्धारित करें।इस गुण को snapshotItem() के साथ संयोजित करके इस्तेमाल करें।
- stringValue
- जब resultType STRING_TYPE हो, परिणाम मूल्य को सहेजें।
XPathResult वस्तु के मेथड
| मेथड | वर्णन |
|---|---|
| iterateNext() | यदि resultType UNORDERED_NODE_ITERATOR_TYPE या ORDERED_NODE_ITERATOR_TYPE हो, इस एकल मेथड का उपयोग करें。 |
| snapshotItem() | परिणाम नोड सूची में निर्दिष्ट इंडेक्स के नोड को वापस करें।यह मेथड तभी उपयोग किया जा सकता है जब resultType UNORDERED_NODE_SNAPSHOT_TYPE या ORDERED_NODE_SNAPSHOT_TYPE हो।snapshotLength अटिबाइट इस मेथड के साथ उपयोग किया जाता है。 |
संबंधित पृष्ठ
- पिछला पृष्ठ DOM XPathExpression
- अगला पृष्ठ DOM XSLTProcessor
