XMLSavePosition (Function)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de archivos XML

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