(C) Removing / Deleting Child Nodes from XML

Demonstrates various methods for removing child nodes from an XML document.

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>

Downloads:

MS Windows Visual C/C++ Libraries

Linux/CentOS C/C++ Libraries

MAC OS X C/C++ Libraries

Solaris C/C++ Libraries

C++ Builder Libraries

FreeBSD C++ Libraries

HP-UX C++ Libraries

BlackBerry QNX C++ Libraries

#include <C_CkXml.h>

void ChilkatSample(void)
    {
    HCkXml xml;
    HCkXml xyz;
    BOOL success;

    xml = CkXml_Create();

    //  The sample input XML is available at http://www.chilkatsoft.com/data/fruit.xml
    success = CkXml_LoadXmlFile(xml,"fruit.xml");
    if (success != TRUE) {
        printf("%s\n",CkXml_lastErrorText(xml));
        return;
    }

    //  The RemoveChild method removes (discards) all direct
    //  children having the specified tag:
    CkXml_RemoveChild(xml,"fruit");

    //  Show the resulting XML:
    printf("Result with all direct children having a tag equal to \"fruit\" removed:\n");
    printf("%s\n",CkXml_getXml(xml));

    //  The XML with the "fruit" direct children removed is shown below:
    //  Notice that the "fruit" node beneath "xyz" was not removed.
    //  This correct because it was not a direct child of the calling node.
    //  
<root>
    <veg color="orange">carrot</veg>
    <meat animal="cow">beef</meat>
    <xyz>
        <fruit color="blue">blueberry</fruit>
        <veg color="green">broccoli</veg>
    </xyz>
    <cheese color="yellow">cheddar</cheese>
</root>


    //  --------------------------------------------------------------------------
    //  Restore the original XML:
    success = CkXml_LoadXmlFile(xml,"fruit.xml");

    //  The RemoveChildWithContent method removes the child
    //  having the exact content specified, regardless of the tag.
    //  For example:
    CkXml_RemoveChildWithContent(xml,"pear");

    //  Show the resulting XML:
    printf("Result with the node containing \"pear\" removed:\n");
    printf("%s\n",CkXml_getXml(xml));

    //  --------------------------------------------------------------------------
    //  Restore the original XML:
    success = CkXml_LoadXmlFile(xml,"fruit.xml");

    //  The RemoveChildByIndex method removes the Nth direct
    //  child.  Indexing begins at 0.  The "xyz" child is at index 4:
    CkXml_RemoveChildByIndex(xml,4);

    //  Show the resulting XML:
    //  Notice that the entire "xyz" subtree is removed.
    printf("Result with the node at index 4 removed:\n");
    printf("%s\n",CkXml_getXml(xml));

    //  --------------------------------------------------------------------------
    //  Restore the original XML:
    success = CkXml_LoadXmlFile(xml,"fruit.xml");

    //  Navigate to the node with tag "xyz"
    xyz = CkXml_FindChild(xml,"xyz");

    //  Remove the "xyz" subtree making it it's own XML document
    //  with the "xyz" node at the root:
    CkXml_RemoveFromTree(xyz);

    //  Show both XML documents:
    printf("%s\n",CkXml_getXml(xyz));
    printf("%s\n",CkXml_getXml(xml));

    //  Also, the TreeId property is an integer value assigned
    //  to nodes in an XML document.  All nodes belonging to
    //  the same XML document will have the same TreeId.
    //  Notice that the "xyz" node now has a different TreeId:
    printf("xyz TreeId = %d\n",CkXml_getTreeId(xyz));
    printf("xml TreeId = %d\n",CkXml_getTreeId(xml));

    CkXml_Dispose(xyz);


    CkXml_Dispose(xml);

    }