XMLRoot (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

XML file management functions

Handling elements in the XML code

Using XMLRoot during a search

XML functions and threads

See also

Constants for managing XML documents

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

XMLFindNamespaceByName

XMLFindNamespaceByURI

Handling elements in the XML code
Using XMLRoot during a search
XML functions and threads

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

XMLRoot (Function)

In french: XMLRacine

Positions on the root tag of an XML document.

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.

Example

See additional examples

IF XMLDocument("MyXMLDoc", XMLCode) = True THEN
// Find the links
XMLFind("MyXMLDoc", "a", XMLTag)
WHILE XMLFound("MyXMLDoc") = True
// Process
// ...
// Next element in the search
XMLNext("MyXMLDoc")
END
// Position on the root
XMLRoot("MyXMLDoc")
// New search
XMLFind("MyXMLDoc", "Link", XMLTag)
WHILE XMLFound("MyXMLDoc") = True
// Process
// ...
// Next element in the search
XMLNext("MyXMLDoc")
END
END

Syntax

<Result> = XMLRoot(<XML document>)

<Result>: Boolean

True if an element was found,
False otherwise. If an error occurs:
the current position remains unchanged.
the ErrorOccurred variable is set to True. To get the details of the error, use ErrorInfo.

<XML document>: Character string

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

Remarks

Handling elements in the XML code

After XMLRoot, the current element can be handled by XMLElementName, XMLParentName, XMLElementType and XMLData.

Using XMLRoot during a search

If a search is in progress (XMLFind), XMLRoot cancels this search.

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.

If the current position in an XML document is modified in a thread, the current position in this XML document is modified for all the threads.

Component: wd270xml.dll