(Perl) 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 Perl Module Downloads for Windows, Linux, and MAC OS X

use chilkat();

$xml = new chilkat::CkXml();

#  The sample input XML is available at http://www.chilkatsoft.com/data/fruit.xml
$success = $xml->LoadXmlFile("fruit.xml");
if ($success != 1) {
    print $xml->lastErrorText() . "\r\n";
    exit;
}

#  Find the direct child node having the tag "meat", and
#  return a new instance of the XML object referencing the
#  child node, if found.
# child is a CkXml
$child = $xml->FindChild("meat");
if ($child eq null ) {
    print "No direct child having the tag \"meat\" was found." . "\r\n";
}
else {
    print "Content = " . $child->content() . "\r\n";

}

#  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.
$success = $xml->FindChild2("meat");
if ($success == 1) {
    #  Success!  The xml object now references the found child.
    print "Content = " . $xml->content() . "\r\n";
    #  Restore the reference back to the parent.
    $xml->GetParent2();
}
else {
    print "No direct child having the tag \"meat\" was found." . "\r\n";
}