XMLSavePosition (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Standard functions

XML file management functions

Prefix syntax

XMLSavePosition

Presentation

Example

Saving several positions

XML functions and threads

See also

Constants for managing XML documents

JSONToXML

JSONXMLConverter

Management of XML

Managing the XSD

Modifying an SVG image (XML functions)

TextToXML

Usage example of the XML types

XML functions

XML management: Use example

XML: Using files exceeding several gigabytes

XMLAddAttribute

XMLAddChild (Example)

XMLAddChild

XMLBuildString (Example)

XMLBuildString

XMLCancelSearch

XMLChild (Example)

XMLChild

XMLChildExist

XMLClose

XMLData (Example)

XMLData

XMLDelete (Example)

XMLDelete

XMLDocument

XMLDocument (Example)

XMLDocument

XMLElementName (Example)

XMLElementName

XMLElementType

XMLExecuteXPath (Example)

XMLExecuteXPath

XMLExtractDocument

XMLExtractString

XMLFind (Example)

XMLFind

XMLFindNamespaceByName

XMLFindNamespaceByURI

XMLFirst

XMLFound

XMLInsertDocument

XMLInsertElement

XMLLast

XMLModify

XMLNamespace

XMLNamespaceURI

XMLNext

XMLOpen

XMLOpenReader (Example)

XMLOpenReader

XMLOut

XMLParent (Example)

XMLParent

XMLParentName

XMLPath

XMLPrevious

XMLRead

XMLRename

XMLRestorePosition (Example)

XMLRestorePosition

XMLResult

XMLRoot (Example)

XMLRoot

XMLSave

XMLSavePosition (Example)

XMLSavePosition

XMLSign

XMLToJSON

XMLToText

XMLValidDocument

XMLValidNode

XMLWrite

xmlAttribute

xmlDocument

xmlNamespace

xmlNode

xmlReader

xpathResult

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

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

Name of the 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. For more details on threads, see Managing threads.

Business / UI classification: Business Logic

Component: wd270xml.dll