juce_XmlElement.h File Reference

Classes
class	XmlElement
	Used to build a tree of elements representing an XML document. More...
Defines
#define	forEachXmlChildElement(parentXmlElement, childElementVariableName)
	A handy macro to make it easy to iterate all the child elements in an XmlElement.
#define	forEachXmlChildElementWithTagName(parentXmlElement, childElementVariableName, requiredTagName)
	A macro that makes it easy to iterate all the child elements of an XmlElement which have a specified tag.

---

Define Documentation

#define forEachXmlChildElement	(		parentXmlElement,
			childElementVariableName
	)

Value:

\
    for (juce::XmlElement* childElementVariableName = (parentXmlElement).getFirstChildElement(); \
         childElementVariableName != nullptr; \
         childElementVariableName = childElementVariableName->getNextElement())

A handy macro to make it easy to iterate all the child elements in an XmlElement.

The parentXmlElement should be a reference to the parent XML, and the childElementVariableName will be the name of a pointer to each child element.

E.g.

    XmlElement* myParentXml = createSomeKindOfXmlDocument();

    forEachXmlChildElement (*myParentXml, child)
    {
        if (child->hasTagName ("FOO"))
            doSomethingWithXmlElement (child);
    }

See also:

forEachXmlChildElementWithTagName

#define forEachXmlChildElementWithTagName	(		parentXmlElement,
			childElementVariableName,
			requiredTagName
	)

Value:

\
    for (juce::XmlElement* childElementVariableName = (parentXmlElement).getChildByName (requiredTagName); \
         childElementVariableName != nullptr; \
         childElementVariableName = childElementVariableName->getNextElementWithTagName (requiredTagName))

A macro that makes it easy to iterate all the child elements of an XmlElement which have a specified tag.

This does the same job as the forEachXmlChildElement macro, but only for those elements that have a particular tag name.

The parentXmlElement should be a reference to the parent XML, and the childElementVariableName will be the name of a pointer to each child element. The requiredTagName is the tag name to match.

E.g.

    XmlElement* myParentXml = createSomeKindOfXmlDocument();

    forEachXmlChildElementWithTagName (*myParentXml, child, "MYTAG")
    {
        // the child object is now guaranteed to be a <MYTAG> element..
        doSomethingWithMYTAGElement (child);
    }

See also:

forEachXmlChildElement