XMLChild (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / XML file functions

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

WINDEV

WEBDEV

WINDEV Mobile

Others

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.

Example

See additional examples

// Création du document XML
XMLDocument("CdeXML", SourceMonXML)
// Parcours effectué avec XMLPremier, XMLSuivant
// Positionne sur l'élément "<commande>"
XMLFirst("CdeXML")
// Descend d'un niveau et positionne sur l'élément "<numero>"
XMLChild("CdeXML")
// Récupère le numéro de la commande
NumCde is int = Val(XMLData("CdeXML")) // contient 1

// Récupération du contenu XML du fichier "commande.xml"
SourceMonXML is string = fLoadText("commande.xml")
// Création du document XML
XMLDocument("CdeXML", SourceMonXML)
IF ErrorOccurred = True THEN
	Error("Erreur lors de la création du document XML")
	RETURN
ELSE
	// Parcours effectué avec XMLPremier, XMLSuivant
	// Positionne sur l'élément "<commande>"
	XMLFirst("CdeXML")
	// Descend d'un niveau et positionne sur l'élément "<numero>"
	XMLChild("CdeXML")
	// Récupère le numéro de la commande
	NumCde is int = Val(XMLData("CdeXML")) // contient 1
END

Syntax

<Result> = XMLChild(<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 more details on the error, use ErrorInfo.

<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

Handling elements in the XML code

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

Note The XMLExtractDocument function can be used to browse only the contents of a tag, and the XMLOut function can be used to warn of the end of the browse.

Using XMLChild during a search

If a search is in progress (XMLFind), XMLChild 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: wd300xml.dll