Function

PurpleXmlNodefrom_str

since: 3.0

Declaration [src]

PurpleXmlNode*
purple_xmlnode_from_str (
  const char* str,
  gssize size
)

Description [src]

Creates a node from a string of XML. Calling this on the root node of an XML document will parse the entire document into a tree of nodes, and return the PurpleXmlNode of the root.

Available since: 3.0

Parameters

str

Type: const char*

The string of xml.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
size

Type: gssize

The size of the string, or -1 if str is NUL-terminated.

Return value

Type: PurpleXmlNode

The new node.

The caller of the function takes ownership of the data, and is responsible for freeing it.