Restores the previously saved context of an XML document (XMLSavePosition
). The current filter when saving the position can be restored (the filter is implemented by XMLFind
IF XMLDocument("MyXMLDoc", XMLCode) = True THEN
// Find the links
XMLFind("MyXMLDoc", "a", XMLTag)
WHILE XMLFound("MyXMLDoc") = True
IF XMLChildExist("MyXMLDoc", XMLAttribute) = True THEN
TheXMLPosition is int = XMLSavePosition("MyXMLDoc")
XMLRestorePosition("MyXMLDoc", TheXMLPosition, XMLRPFilter)
// Next element in the search
<Result> = XMLRestorePosition(<XML document> , <Position> [, <Options>])
- True if the position is restored,
- False otherwise (the ErrorOccurred variable is set to True). To get more details on the error, use ErrorInfo.
<XML document>: Character string
Name of the XML document used. This document contains the XML code to study and it was created by XMLDocument.
Position to restore. This position was returned by XMLSavePosition.
<Options>: Optional constant (or combination of constants)
Used to configure the restore operation:
|The position is freed. The stored position is restored.|
|XMLRPFilter||Restores the filter implemented by XMLSavePosition.|
|XMLRPKeep||The position is not freed (other calls to XMLRestorePosition can be performed on this position).|
XML functions and threads
If your application uses threads, the XML document is shared between all these threads. For more details on threads, see Managing threads
Business / UI classification: Business Logic