Xml Node¶

1

import "std/text/xml-node";

XmlNode struct¶

Represents a node in an XML document.

Element nodes carry a tag name, ordered attributes and ordered child nodes (which may themselves be elements or text). Text nodes carry only the decoded character data. Children are owned as heap pointers so the parsed tree is reached via XmlNode* (heap on the root).

Parsing lives in "std/text/xml-parser" and serialization in "std/text/xml-serializer", so programs only pull in what they use.

Constructors¶

ctor¶

1

public p XmlNode.ctor()

Construct an empty XML element node

ctor¶

1

public p XmlNode.ctor(XmlNodeKind kind)

Construct an empty XML node of the given kind

Parameters

Methods¶

getKind¶

1

public f<XmlNodeKind> XmlNode.getKind()

Retrieve the kind of the XML node

Returns: XmlNodeKind — Kind of the node

isElement¶

1

public f<bool> XmlNode.isElement()

Check whether the node is an element node

Returns: bool — true if the node is an element, false otherwise

isText¶

1

public f<bool> XmlNode.isText()

Check whether the node is a text node

Returns: bool — true if the node is text, false otherwise

getName¶

1

public f<const String&> XmlNode.getName()

Retrieve the tag name of the element. Panics if the node is not an element.

Returns: const String& — Tag name

setName¶

1

public p XmlNode.setName(const String& name)

Set the tag name of the element. Panics if the node is not an element.

Parameters

getText¶

1

public f<const String&> XmlNode.getText()

Retrieve the character data of the text node. Panics if the node is not a text node.

Returns: const String& — Text content

setText¶

1

public p XmlNode.setText(const String& text)

Set the character data of the text node. Panics if the node is not a text node.

Parameters

getAttributeCount¶

1

public f<unsigned long> XmlNode.getAttributeCount()

Retrieve the number of attributes on the element. Panics if the node is not an element.

Returns: unsigned long — Number of attributes

getAttributeKey¶

1

public f<const String&> XmlNode.getAttributeKey(unsigned long idx)

Retrieve the name of the attribute at the given index, in document order. Panics if the node is not an element.

Parameters

Returns: const String& — Attribute name

getAttributeValue¶

1

public f<const String&> XmlNode.getAttributeValue(unsigned long idx)

Retrieve the value of the attribute at the given index, in document order. Panics if the node is not an element.

Parameters

Returns: const String& — Attribute value

hasAttribute¶

1

public f<bool> XmlNode.hasAttribute(string name)

Check whether the element has an attribute with the given name

Parameters

Returns: bool — true if the attribute exists, false otherwise

getAttribute¶

1

public f<const String&> XmlNode.getAttribute(string name)

Retrieve the value of the attribute with the given name. Panics if the node is not an element or the attribute does not exist.

Parameters

Returns: const String& — Attribute value

addAttribute¶

1

public p XmlNode.addAttribute(const String& name, const String& value)

Append an attribute to the element. Panics if the node is not an element. The caller is responsible for avoiding duplicate attribute names.

Parameters

getChildCount¶

1

public f<unsigned long> XmlNode.getChildCount()

Retrieve the number of child nodes. Panics if the node is not an element.

Returns: unsigned long — Number of child nodes

getChild¶

1

public f<XmlNode*> XmlNode.getChild(unsigned long idx)

Retrieve the child node at the given index. Panics if the node is not an element.

Parameters

Returns: XmlNode* — Pointer to the child node

getChild¶

1

public f<XmlNode*> XmlNode.getChild(unsigned int idx)

Retrieve the child node at the given index. Panics if the node is not an element.

Parameters

Returns: XmlNode* — Pointer to the child node

addChild¶

1

public p XmlNode.addChild(XmlNode* child)

Append a child node to the element. Panics if the node is not an element. The element takes ownership of the heap-allocated child.

Parameters

findChild¶

1

public f<XmlNode*> XmlNode.findChild(string name)

Find the first child element with the given tag name. Returns nil if none exists. Text-node children are ignored.

Parameters

Returns: XmlNode*

hasChild¶

1

public f<bool> XmlNode.hasChild(string name)

Check whether the element has a direct child element with the given tag name

Parameters

Returns: bool — true if such a child exists, false otherwise

getInnerText¶

1

public f<String> XmlNode.getInnerText()

Concatenated text of all direct text-node children, in document order. Useful for elements like <title>Hello</title> where the natural value is the text content.

Returns: String

XmlNodeKind enum¶

Tag for the variant stored inside an XmlNode.