(Visual FoxPro) Find Direct Child with Specific Tag

Demonstrates how to find a direct child having a specific tag.

The input XML, available at http://www.chilkatsoft.com/data/fruit.xml, is this:

<root>
    <fruit color="red">apple</fruit>
    <fruit color="green">pear</fruit>
    <veg color="orange">carrot</veg>
    <meat animal="cow">beef</meat>
    <xyz>
        <fruit color="blue">blueberry</fruit>
        <veg color="green">broccoli</veg>
    </xyz>
    <fruit color="purple">grape</fruit>
    <cheese color="yellow">cheddar</cheese>
</root>

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loXml
LOCAL lnSuccess
LOCAL loChild

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Xml')
loXml = CreateObject('Chilkat.Xml')

* The sample input XML is available at http://www.chilkatsoft.com/data/fruit.xml
lnSuccess = loXml.LoadXmlFile("qa_data/xml/fruit.xml")
IF (lnSuccess <> 1) THEN
    ? loXml.LastErrorText
    RELEASE loXml
    CANCEL
ENDIF

* Find the direct child node having the tag "meat", and 
* return a new instance of the XML object referencing the
* child node, if found.
loChild = loXml.FindChild("meat")
IF (loXml.LastMethodSuccess = 0) THEN
    ? 'No direct child having the tag "meat" was found.'
ELSE
    ? "Content = " + loChild.Content
    RELEASE loChild
ENDIF

* The same can be accomplished without creating a new 
* XML object instance.  Instead, the FindChild2 method updates
* the caller's internal reference to the found child, if successful.
lnSuccess = loXml.FindChild2("meat")
IF (lnSuccess = 1) THEN
    * Success!  The xml object now references the found child.
    ? "Content = " + loXml.Content
    * Restore the reference back to the parent.
    lnSuccess = loXml.GetParent2()
ELSE
    ? 'No direct child having the tag "meat" was found.'
ENDIF

RELEASE loXml