XMLSavePosition (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

XML file management functions

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 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

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 : wd260xml.dll