XMLChild (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing XML files

XMLChild

Presentation

Example

Handling elements in the XML code

Using XMLChild during a search

XML functions and threads

See also

XMLChild (Function)

In French: XMLFils

Positions on the first child element of current element. To select an element, use the functions for XML search and browse (XMLFirst, XMLLast, ...).

Reminder: An element is either a tag or an attribute.

The XML comments (found between the "<!-" and "->" tags) are ignored.

The browses are performed in alphabetical order of the attributes.

Versions 15 and later

This function is now available for the Android applications.

New in version 15

This function is now available for the Android applications.

Versions 17 and later

This function is now available for the iPhone/iPad applications.

New in version 17

This function is now available for the 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

// Create the XML document
XMLDocument("XMLOrd", SourceMyXML)
// Browse performed by XMLFirst and XMLNext
// Positions on "<order>" element
XMLFirst("XMLOrd")
// Goes one level down and positions on "<number>" element
XMLChild("XMLOrd")
// Retrieves the order number
OrdNum is int = Val(XMLData("XMLOrd")) // contains 1

// Retrieve the XML content of "orders.xml" file
SourceMyXML is string = fLoadText("orders.xml")
// Create the XML document
XMLDocument("XMLOrd", SourceMyXML)
IF ErrorOccurred = True THEN
Error("Error while creating the XML document")
RETURN
ELSE
// Browse performed by XMLFirst and XMLNext
// Positions on "<order>" element
XMLFirst("XMLOrd")
// Goes one level down and positions on "<number>" element
XMLChild("XMLOrd")
// Retrieves the order number
OrdNum is int = Val(XMLData("XMLOrd")) // contains 1
END

Syntax

<Result> = XMLChild(<Name of 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 find out the error details, use ErrorInfo.

<Name of 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

Handling elements in the XML code

After the call to XMLChild, the current element can be handled by XMLElementName, XMLParentName, XMLElementType and XMLData.

Note: you can use XMLExtractDocument to read only the content of a tag and be notified when you've reached the end with XMLOut.

Using XMLChild during a search

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

XML functions and threads

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

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.

Components

wd230xml.dll

wp230xml.dll

WDJS.DLL

wd230java.jar

wd230xml.so

wd230android.jar