A class to describe an XML object.
Each p5.XML object provides an easy way to interact with XML data. Extensible Markup Language (XML) is a standard format for sending data between applications. Like HTML, the XML format is based on tags and attributes, as in <time units="s">1234</time>.
Note: Use loadXML() to load external XML files.
Examples
Syntax
p5.XML()
Parameters
Methods
Returns the element's name as a String.
An XML element's name is given by its tag. For example, the element language.
Sets the element's tag name.
An XML element's name is given by its tag. For example, the element language.
The parameter, name, is the element's new name as a string. For example, calling myXML.setName('planet') will make the element's new tag name
true if the element has child elements and false if not.Strings.Returns an array with the element's child elements as new p5.XML objects.
The parameter, name, is optional. If a string is passed, as in myXML.getChildren('cat'), then the method will only return child elements with the tag
Returns the first matching child element as a new p5.XML object.
The parameter, name, is optional. If a string is passed, as in myXML.getChild('cat'), then the first child element with the tag myXML.getChild(1), then the child element at that index will be returned.
Adds a new child element and returns a reference to it.
The parameter, child, is the p5.XML object to add as a child element. For example, calling myXML.addChild(otherXML) inserts otherXML as a child element of myXML.
Removes the first matching child element.
The parameter, name, is the child element to remove. If a string is passed, as in myXML.removeChild('cat'), then the first child element with the tag myXML.removeChild(1), then the child element at that index will be removed.
Returns an Array with the names of the element's attributes.
Note: Use myXML.getString() or myXML.getNum() to return an attribute's value.
Returns true if the element has a given attribute and false if not.
The parameter, name, is a string with the name of the attribute being checked.
Note: Use myXML.getString() or myXML.getNum() to return an attribute's value.
Return an attribute's value as a Number.
The first parameter, name, is a string with the name of the attribute being checked. For example, calling myXML.getNum('id') returns the element's id attribute as a number.
The second parameter, defaultValue, is optional. If a number is passed, as in myXML.getNum('id', -1), it will be returned if the attribute doesn't exist or can't be converted to a number.
Note: Use myXML.getString() or myXML.getNum() to return an attribute's value.
Return an attribute's value as a string.
The first parameter, name, is a string with the name of the attribute being checked. For example, calling myXML.getString('color') returns the element's id attribute as a string.
The second parameter, defaultValue, is optional. If a string is passed, as in myXML.getString('color', 'deeppink'), it will be returned if the attribute doesn't exist.
Note: Use myXML.getString() or myXML.getNum() to return an attribute's value.
Sets an attribute to a given value.
The first parameter, name, is a string with the name of the attribute being set.
The second parameter, value, is the attribute's new value. For example, calling myXML.setAttribute('id', 123) sets the id attribute to the value 123.
Returns the element's content as a String.
The parameter, defaultValue, is optional. If a string is passed, as in myXML.getContent('???'), it will be returned if the element has no content.
Returns the element as a String.
myXML.serialize() is useful for sending the element over the network or saving it to a file.