(Perl) XML SearchForTag Method

Demonstrates the SearchForTag and SearchForTag2 methods.

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

<root>
    <searchRoot>
        <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>
    </searchRoot>
    <fruit color="red">strawberry</fruit>
    <fruit color="orange">peach</fruit>
    <root></root>
</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/fruitSearch.xml
$success = $xml->LoadXmlFile("fruitSearch.xml");
if ($success != 1) {
    print $xml->lastErrorText() . "\r\n";
    exit;
}

#  Search the sub-tree rooted at "searchRoot"
# xSearchRoot is a CkXml
$xSearchRoot = $xml->FindChild("searchRoot");

#  Search for all nodes having the tag "fruit"
# xBeginAfter is a CkXml
$xBeginAfter = null;
# xFound is a CkXml
$xFound = $xSearchRoot->SearchForTag($xBeginAfter,"fruit");
while (!($xFound eq null )) {

    print $xFound->content() . "\r\n";

    # xBeginAfter is a CkXml
    $xBeginAfter = $xFound;
    # xFound is a CkXml
    $xFound = $xSearchRoot->SearchForTag($xBeginAfter,"fruit");
}

print "--------------------------" . "\r\n";

#  ---------------------------------------------------------------------------------
#  Now do the same, but instead use SearchForTag2
#  which updates the internal reference of the caller instead
#  of returning the found node.

# xBeginAfter is a CkXml
$xBeginAfter = $xSearchRoot->GetSelf();
# xSearch is a CkXml
$xSearch = $xSearchRoot->GetSelf();

$success = $xSearch->SearchForTag2($xBeginAfter,"fruit");
while ($success == 1) {

    print $xSearch->content() . "\r\n";

    #  Copy the internal references so that the next search
    #  begins after the found node.
    $xBeginAfter->CopyRef($xSearch);
    $xSearch->CopyRef($xSearchRoot);

    $success = $xSearch->SearchForTag2($xBeginAfter,"fruit");
}