XML DOM XPathResult ਵਸਤੂ

XPath کی جانچ کا نتیجہ

XPathResult آئی-چیئر

XPathResult آئی-چیئر ایک XPath جملے کا کاروبار اے۔ اس طرح کا آئی-چیئر Document.evaluate() ਅਤੇ XPathExpression.evaluate() بٹنو. XPath کی جانچ نئی کیتنی وسیلوؤں نال کی جاسکتی اے، جو چینک، نمبر، بولین ولوؤن، نیود، یا نیود کی لسٹ اے۔ XPath کی جاریوؤن نیود کی لسٹ نئی کتنی وسیلوؤن نال درج کی جاسکتی اے، اس لئی، اس اوبجیکٹ کو ایک XPath جانچ کا حقیقی نتیجہ حاصل کرنے کیلئے کچھ پیچیدگی والی API کی تعریف کردا اے۔

ਇੱਕ XPathResult ਦੀ ਵਰਤੋਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ resultType ਗੁਣ ਚੈਕ ਕਰੋ।ਇਹ ਗੁਣ ਇੱਕ XPathResult ਨਿਯਮ ਸੰਭਾਲਦਾ ਹੈ।ਇਸ ਗੁਣ ਦੇ ਮੁੱਲ ਦੇ ਅਨੁਸਾਰ ਉਹ ਗੁਣ ਅਤੇ ਮੈਥਡ ਵਰਤਣ ਜਿਸ ਨਾਲ ਨਤੀਜਾ ਮੁੱਲ ਨੂੰ ਸਪੱਸ਼ਟ ਕੀਤਾ ਜਾਵੇਗਾ।ਇਸ ਨਿਯਮ ਦੇ ਲਈ ਨਾ ਦੱਸੇ ਗਏ ਮੈਥਡ ਜਾਂ ਗੁਣ ਦੀ ਸੋਧ ਕਰਨਾ ਗਲਤੀ ਪੈਦਾ ਕਰ ਸਕਦਾ ਹੈ।

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 ਪ੍ਰਤੀਯੋਗ ਦੇ ਨਾਲ ਇਹ ਮੈਥਡ ਵਰਤਿਆ ਜਾਵੇਗਾ。

ਸਬੰਧਤ ਪੰਨੇ

Document.evaluate() ਅਤੇ XPathExpression.evaluate()