XMLSavePosition (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing XML files

Saving several positions

XML functions and threads

See also

Constants for managing XML documents

Example for using the XML types

XML management: Use example

XML: Using files exceeding several gigabytes

XMLFindNamespaceByName

XMLFindNamespaceByURI

Saving several positions
XML functions and threads

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

XMLSavePosition (Function)

In french: XMLSauvePosition

Stores the current position in the XML document. This enables you to temporarily suspend the current process in order for the XML document to be used somewhere else (to perform checks for example). The saved context can be restored by XMLRestorePosition. Then, the main process can continue.

Remark: XMLSavePosition saves the current filter (the filter is implemented by XMLFind).

Versions 25 and later

This function is now available in browser code.

New in version 25

This function is now available in browser code.

Example

See additional examples

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> = XMLSavePosition(<XML document>)

<Result>: Integer

Number of the position that was saved,
-1 if an error occurred.

<XML document>: Character string (with quotes)

Name of XML document used. This document contains the XML code to study and it was created by XMLDocument.

Remarks

Saving several positions

XMLSavePosition can be used several times to save several positions in the XML file. To do so, assign the position to different integer variables. Then, these different positions can be restored by XMLRestorePosition.

XML functions and threads

If your application uses threads, the XML document is shared between all these threads. See Managing threads for more details.

Business / UI classification : Business Logic

Component : wd250xml.dll