Functions

mxmlAdd()
mxmlDelete()
mxmlElementGetAttr()
mxmlElementSetAttr()
mxmlFindElement()
mxmlLoadFile()
mxmlNewElement()
mxmlNewInteger()
mxmlNewOpaque()
mxmlNewReal()
mxmlNewText()
mxmlRemove()
mxmlSaveFile()
mxmlWalkNext()
mxmlWalkPrev()

mxmlAdd()

Add a node to a tree.

Syntax

void
mxmlAdd(
    mxml_node_t * parent,
    int where,
    mxml_node_t * child,
    mxml_node_t * node);

Arguments

Name	Description
`parent`	Parent node
`where`	Where to add
`child`	Child node for where
`node`	Node to add

Returns

Nothing.

mxmlDelete()

Delete a node and all of its children.

Syntax

void
mxmlDelete(
    mxml_node_t * node);

Arguments

Name	Description
`node`	Node

Returns

Nothing.

mxmlElementGetAttr()

Get an attribute.

Syntax

const char *
mxmlElementGetAttr(
    mxml_node_t * node,
    const char * name);

Arguments

Name	Description
`node`	Element node
`name`	Name of attribute

Returns

Attribute value or NULL

mxmlElementSetAttr()

Set an attribute.

Syntax

void
mxmlElementSetAttr(
    mxml_node_t * node,
    const char * name,
    const char * value);

Arguments

Name	Description
`node`	Element node
`name`	Name of attribute
`value`	Attribute value

Returns

Nothing.

mxmlFindElement()

Find the named element.

Syntax

mxml_node_t *
mxmlFindElement(
    mxml_node_t * node,
    mxml_node_t * top,
    const char * name,
    const char * attr,
    const char * value,
    int descend);

Arguments

Name	Description
`node`	Current node
`top`	Top node
`name`	Element name or NULL for any
`attr`	Attribute name, or NULL for none
`value`	Attribute value, or NULL for any
`descend`	Descend into tree?

Returns

Element node or NULL

mxmlLoadFile()

Load a file into an XML node tree.

Syntax

mxml_node_t *
mxmlLoadFile(
    mxml_node_t * top,
    FILE * fp,
    mxml_type_t (*cb)(mxml_node_t *));

Arguments

Name	Description
`top`	Top node
`fp`	File to read from
`(cb)(mxml_node_t )`	Callback function

Returns

First node

mxmlNewElement()

Create a new element node.

Syntax

mxml_node_t *
mxmlNewElement(
    mxml_node_t * parent,
    const char * name);

Arguments

Name	Description
`parent`	Parent node
`name`	Name of element

Returns

New node

mxmlNewInteger()

Create a new integer node.

Syntax

mxml_node_t *
mxmlNewInteger(
    mxml_node_t * parent,
    int integer);

Arguments

Name	Description
`parent`	Parent node
`integer`	Integer value

Returns

New node

mxmlNewOpaque()

Create a new opaque string.

Syntax

mxml_node_t *
mxmlNewOpaque(
    mxml_node_t * parent,
    const char * opaque);

Arguments

Name	Description
`parent`	Parent node
`opaque`	Opaque string

Returns

New node

mxmlNewReal()

Create a new real number node.

Syntax

mxml_node_t *
mxmlNewReal(
    mxml_node_t * parent,
    double real);

Arguments

Name	Description
`parent`	Parent node
`real`	Real number value

Returns

New node

mxmlNewText()

Create a new text fragment node.

Syntax

mxml_node_t *
mxmlNewText(
    mxml_node_t * parent,
    int whitespace,
    const char * string);

Arguments

Name	Description
`parent`	Parent node
`whitespace`	Leading whitespace?
`string`	String

Returns

New node

mxmlRemove()

Remove a node from its parent.

Syntax

void
mxmlRemove(
    mxml_node_t * node);

Arguments

Name	Description
`node`	Node to remove

Returns

Nothing.

mxmlSaveFile()

Save an XML tree to a file.

Syntax

int
mxmlSaveFile(
    mxml_node_t * node,
    FILE * fp,
    int (*cb)(mxml_node_t *int));

Arguments

Name	Description
`node`	Node to write
`fp`	File to write to
`(cb)(mxml_node_t int)`	Whitespace callback

Returns

0 on success, -1 on error

mxmlWalkNext()

Walk to the next logical node in the tree.

Syntax

mxml_node_t *
mxmlWalkNext(
    mxml_node_t * node,
    mxml_node_t * top,
    int descend);

Arguments

Name	Description
`node`	Current node
`top`	Top node
`descend`	Descend into tree?

Returns

Next node or NULL

mxmlWalkPrev()

Walk to the previous logical node in the tree.

Syntax

mxml_node_t *
mxmlWalkPrev(
    mxml_node_t * node,
    mxml_node_t * top,
    int descend);

Arguments

Name	Description
`node`	Current node
`top`	Top node
`descend`	Descend into tree?

Returns

Previous node or NULL