PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Handling elements in the XML code
  • Using XMLChild during a search
  • XML functions and threads
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
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.
PHP The XML comments (found between the "<!-" and "->" tags) are ignored.
AndroidAndroid Widget Java The browses are performed in alphabetical order of the attributes.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
// 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
WINDEVWEBDEV - Server codeReports and QueriesWindows MobileUniversal Windows 10 AppJavaPHPAjaxUser code (UMC)
// 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
WINDEVWEBDEV - Server codeReports and Queries wd230xml.dll
Windows Mobile wp230xml.dll
WEBDEV - Browser code WDJS.DLL
Java wd230java.jar
Linux wd230xml.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment