# Sablotron Guide and Reference

DOM functions | DOM

#### Summary

Functions introduced by `.Sablotron DOM` Level 2 interface.

#### Description

The functions listed below are implemented as defined in the `DOM Level 2` specification, with two exceptions: their names are prefixed with SDOM_ and the first argument is always a SablotSituation. All the functions return a value of SDOM_Exception type. The functions aren't described in details as they correspond to well known DOM methods. Please, look to sdom.h for more details.

`createElement`, `createElementNS`, `createAttribute`, `createAttributeNS`, `createTextNode`, `createCDATASection`, `createComment`, `createProcessingInstruction`

`getNodeType`, `getNodeName`, `getNodeNSUri`, `getNodePrefix`, `getNodeLocalName`, `setNodeName`, `getNodeValue`, `setNodeValue`

`getParentNode`, `getFirstChild`, `getLastChild`, `getPreviousSibling`, `getNextSibling`, `getChildNodeIndex`, `getChildNodeCount`, `getOwnerDocument`

`insertBefore`, `appendChild`, `removeChild`, `replaceChild`

`cloneNode`

`getAttribute`, `getAttributeNS`, `getAttributeNode`, `getAttributeNodeNS`, `getAttributeNodeIndex`, `getAttributeNodeCount`, `setAttribute`, `setAttributeNS`, `setAttributeNode`, `setAttributeNodeNS`, `removeAttribute`, `removeAttributeNode`, `getAttributeElement`, `getAttributeList`

Several functions have been added:

`disposeNode` frees all memory used by the given node.

`cloneForeignNode` clones a node from a different document.

`docToString` serializes the document, returning the resulting string.

`nodeToString` serializes a node (and its descendants), returning the resulting string.

`xql` performs an XPath query on the DOM tree, returning a list of the nodes satisfying the query.

In addition, there are some functions used to manipulate the node lists returned by xql and getAttributeList functions. These include `getNodeListLength`, `getNodeListItem` and `disposeNodeList`.

Finally, there are functions to extract DOM exception-related information from the situation object, namely `getExceptionCode`, `getExceptionMessage` and `getExceptionDetails`.

#### See Also

Groups | [ DOM ]
Entries | [ .Sablotron DOM ]

© 2002-2003 Ginger Alliance
revision 03-06-30
This page was generated by APIDOC