XML DOM XPathResult ఆబ్జెక్ట్

XPath అభివ్యక్తి యొక్క ఫలితం

XPathResult ఆధారం

XPathResult ఆధారం ఒక XPath అభివ్యక్తి యొక్క విలువను ప్రతినిధీకరిస్తుంది. ఈ రకమైన ఆధారం ద్వారా Document.evaluate() మరియు XPathExpression.evaluate() తిరిగి వస్తాయి. XPath కొరకు వర్ణము, సంఖ్య, బుల్ విలువలు, నోడు మరియు నోడు జాబితాలను గణించవచ్చు. XPath అమలు నోడు జాబితాలను పలు విధాలుగా తిరిగి ఇవ్వవచ్చు, అందువల్ల ఈ ఆధారం రియల్ జాబితా ని పొందడానికి కంప్లికేటడ్ ఏపిఐ ని నిర్వచించింది.

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 అనేది ఒక ప్రత్యేక విలువను కాక పనిచేయదు. ప్రస్తుత విలువను నిర్వచించని గుణాలను ప్రవేశపెట్టినప్పుడు అపరిశుభ్రమైన సమస్య తయారవుతుంది.

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()