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")
XMLChild("myXMLDoc")
Trace(XMLData("MyXMLDoc"))
// Process
XMLRestorePosition("MyXMLDoc", TheXMLPosition, XMLRPFilter)
END
// Next element in the search
XMLNext("MyXMLDoc")
END
END
Syntax
<Result> = XMLRestorePosition(<XML document> , <Position> [, <Options>])
<Result>: Integer
- 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>: Integer
Position to restore. This position was returned by XMLSavePosition.
<Options>: Optional constant (or combination of constants)
Used to configure the restore operation: | |
XMLRPDefault
(default value) | 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). |
Remarks
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