Inheritance diagram

Collaboration diagram

Description

An Element node(SFXXMLElement) contains an element of the XML document.

An Attribute node(SFXXMLAttribute) can be set to the Element node using the functions such as SFXXMLElement::SetAttributeNode, SFXXMLElement::SetAttribute.

The Attribute node of the Element node can be obtained using the functions such as SFXXMLElement::GetAttributeNode, SFXXMLElement::GetAttributes.

Reference

SFXXMLNode | SFXXMLAttribute | SFXXMLCDATASection | SFXXMLComment | SFXXMLDocument | SFXXMLDocumentFragment | SFXXMLDocumentType | SFXXMLEntity | SFXXMLEntityReference | SFXXMLNotation | SFXXMLProcessingInstruction | SFXXMLText

Member

Return value

Description

The "newchild" node is appended as the last child node to this node without copying it.

If the "newchild" node belongs to a DOM tree, it will be removed from that tree.

Reference

SFXXMLNode::AppendChild | SFXXMLNode

Argument

Return value

Reference

SFXXMLNode::CloneNode | SFXXMLNode

Return value

Reference

SFXXMLNode::EqualNode | SFXXMLNode

Argument

Return value

null is returned if this node has no attribute value.

Description

The attribute value can be obtained by qualified name and namespace URI

Example

// get "xmlns:dt" attribute value 
SFXAnsiString atti = boot->GetAttribute("xmlns:dt");

Reference

SFXXMLElement::GetAttributes | SFXXMLElement::GetAttributeNode | SFXXMLElement::SetAttribute | SFXXMLElement::SetAttributeNode | SFXXMLElement::HasAttribute | SFXXMLElement::HasAttributes | SFXXMLElement::RemoveAttribute | SFXXMLElement::RemoveAttributeNode

Argument

Return value

Return the Attribute node with a specified name. Return null if no Attribute node with this name is found.

Description

The Attribute node can be correctly obtained by specifying the qualified name and namespace URI.

Example

// get "xmlns:dt" Attribute node 
SFXXMLAttributePtr atti = boot->GetAttributeNode("xmlns:dt");

Reference

SFXXMLElement::GetAttribute | SFXXMLElement::GetAttributeNode | SFXXMLElement::SetAttribute | SFXXMLElement::SetAttributeNode | SFXXMLElement::HasAttribute | SFXXMLElement::HasAttributes | SFXXMLElement::RemoveAttribute | SFXXMLElement::RemoveAttributeNode

Return value

Return the pointer to the Attribute nodes of the SFXXMLNode::DOMNamedNodeMap if any. Return null if not.

Example

// check whether this Element node has any Attribute nodes or not  
if (SFXXMLElementPtr(child)->HasAttributes()) {
    // get all the Attribute nodes of this Element node 
    SFXXMLNode::DOMNamedNodeMapPtr attr = SFXXMLElementPtr(child)->GetAttributes();
    if (attr) {
        for (int i = 0; i < attr->GetLength(); i++) {
            SFXXMLNodePtr item = attr->Item(i);
            if (item) {
                if(item->GetNodeType() == SFXXMLNode::ATTRIBUTE_NODE);
                ...
            }                            
        }
    }
}

Reference

SFXXMLNode::DOMNamedNodeMap | SFXXMLElement::GetAttribute | SFXXMLElement::SetAttribute | SFXXMLElement::SetAttributeNode | SFXXMLElement::HasAttribute | SFXXMLElement::HasAttributes | SFXXMLElement::GetAttributeNode | SFXXMLElement::RemoveAttribute | SFXXMLElement::RemoveAttributeNode

Return value

Return the pointer to the SFXXMLNode::DOMNodeList instance that contains all child nodes of this node.

Description

	Note
	Each element of SFXXMLNode::DOMNodeList is of the "pointer to the SFXXMLNode" type.

Example

//get element node by tag name
SFXXMLNode::DOMNodeListPtr list = root->GetElementsByTagName("BOOK");

 if (list) {
    // get the enumerator
    SFXXMLNode::DOMNodeList::Enumerator enumer = list->GetFirstEnumerator();

    while (enumer.HasNext()) {
        // get each element node
        SFXXMLElementPtr elem = static_cast<SFXXMLElementPtr>(enumer.GetNext());
        // get all child nodes of each element node
        SFXXMLNode::DOMNodeListPtr nodeList = elem->GetChildNodes();
        // get enumrator of child nodes
        SFXXMLNode::DOMNodeList::Enumerator childiter = nodeList->GetFirstEnumerator();

        while (childiter.HasNext()) {
            SFXXMLElementPtr child = static_cast<SFXXMLElementPtr>(childiter.GetNext());

            TRACE("child name: %s", child->GetName());    // display name of each child node
            TRACE("child text: %s", child->GetText().GetCString());  // display child node string content
        }
    }
}

Reference

SFXXMLNode::DOMNodeList | SFXXMLNode::GetChildNodes| SFXXMLNode

Return value

Return all the Element nodes that match a specified tag name as the pointer to the SFXXMLNode::DOMNodeList instance.

Reference

SFXXMLNode::DOMNodeList | SFXXMLDocument::GetElementsByTagName

Return value

Return the first child node of this node. Return null if this node has no child.

Reference

SFXXMLNode::GetFirstChild | SFXXMLNode

Return value

Return the last child node of this node. Return null if this node has no child.

Reference

SFXXMLNode::GetLastChild | SFXXMLNode

Return value

Return the local name of this node.

Description

When the name set to this node is qualified name, it is a pair of namespace prefix and local name.

	Note
	The name of the Element node is the element name of the XML document.

Reference

SFXXMLElement::GetPrefix | SFXXMLElement::GetName | SFXXMLElement::GetNamespaceURI

Description

Same as the SFXXMLElement::GetNodeName function.

	Note
	The name of the Element node is the element name of the XML document.

	Note
	When the namespace is set, the qualified name(namespace prefix and local name) is returned.

Example

<?xml version="1.0" encoding="Shift_JIS"?>
<xsl:stylesheet
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns="http://www.w3.org/1999/xhtml"
    version="1.0">
<xsl:output encoding="Shift_JIS"  method="xml"
    doctype-public="-//W3C//DTD XHTML 1.0 Transitional//EN"
    doctype-system="DTD/xhtml1-transitional.dtd"/>
	<xsl:template match="/">
	    <html>
	        <head>
	           <title>words</title>
	        </head>
	        <body bgcolor="#CCFFFF">
	            <center>
	                <table border="0">
	                    <xsl:apply-templates select=".//def"/>
	                </table>
	            </center>
	        </body>
	    </html>
	</xsl:template>
	<xsl:template match="def">
	    <tr><td><b><xsl:apply-templates/></b></td></tr>
	</xsl:template>
	<xsl:template match="text()">
	    <xsl:value-of select="."/>
	</xsl:template>
</xsl:stylesheet>


// get Element node
SFXXMLElementPtr stylesheet = document.GetDocumentElement();
TRACE("Element's name = %s", stylesheet->GetName());           // name as qualified name = xsl:stylesheet 
TRACE("Element's localname = %s", stylesheet->GetLocalName()); // local name             = stylesheet 
TRACE("Element's prefix = %s", stylesheet->GetPrefix());       // prefix   	          = xsl 
TRACE("Element's uri = %s", stylesheet->GetNamespaceURI());    // namespace URI          = http://www.w3.org/1999/XSL/Transform 
 

Reference

SFXXMLElement::GetLocalName | SFXXMLElement::GetNodeName | SFXXMLElement::GetPrefix | SFXXMLElement::GetNamespaceURI

Return value

Return the namespace URI of this node if set. Otherwise, return null.

Reference

SFXXMLElement::GetPrefix | SFXXMLElement::GetName | SFXXMLElement::GetLocalName

Return value

Return the next sibling node of this node. If this node has no next sibling node, null is returned.

Example

SFXXMLDOMParser parser;    // parse XML document by DOM method

// get root node of DOM tree
SFXXMLDocumentPtr root = parser.GetDocument();

// get first child of root node
SFXXMLNodePtr node = root->GetFirstChild();

SFXXMLElementPtr elem = static_cast<SFXXMLElementPtr>(node); // convert into Element pointer type   

SFXXMLNodePtr child = elem->GetFirstChild();     // get first child node    
SFXXMLNodePtr author = child->GetNextSibling();  // get next sibling node

Reference

SFXXMLElement::GetPreviousSibling | SFXXMLNode::GetNextSibling| SFXXMLNode::GetPreviousSibling | SFXXMLNode

Description

Same as the SFXXMLElement::GetName function.

	Note
	The name of the Element node is the element name of the XML document.

	Note
	When the namespace is set, the qualified name(namespace prefix and local name) is returned.

Reference

SFXXMLElement::GetName | SFXXMLNode::GetNodeName | SFXXMLNode

Return value

Return ELEMENT_NODE.

Reference

SFXXMLNode::NodeType | SFXXMLNode::GetNodeType | SFXXMLNode

Return value

Return the parent node of this node. Return null if this node has no parent.

Reference

SFXXMLNode::GetParentNode | SFXXMLNode

Return value

Return the prefix of this node if set. Otherwise return null.

Reference

SFXXMLElement::GetName

Return value

Return the previous sibling node of this node. If this node has no previous sibling node, null is returned.

Reference

SFXXMLElement::GetNextSibling | SFXXMLNode::GetPreviousSibling | SFXXMLNode::GetNextSibling | SFXXMLNode

return value

Example

// check whether the Attribute node with name of "isdn" exists or not 
if(book->HasAttribute("isdn") == false){
    .....
}

Reference

SFXXMLElement::HasAttributes | SFXXMLElement::SetAttribute | SFXXMLElement::SetAttributeNode | SFXXMLElement::SetAttribute | SFXXMLElement::SetAttributeNode | SFXXMLElement::GetAttribute | SFXXMLElement::GetAttributes | SFXXMLElement::RemoveAttribute | SFXXMLElement::RemoveAttributeNode

Example

// check whether any Attribute nodes exist or not
if(book->HasAttributes() == false){
    .....
}

Reference

SFXXMLElement::HasAttribute | SFXXMLElement::GetAttribute | SFXXMLElement::GetAttributes | SFXXMLElement::RemoveAttribute | SFXXMLElement::RemoveAttributeNode

Return value

Reference

SFXXMLNode::HasChildNodes | SFXXMLNode

Return value

Description

Insert the newchild node before the refchild node. If the refchild argument is specified as null, append the newchild node as the last child node.

When the newchild node is the DocumentFragment node, all the child nodes of the newchild node are inserted in the same order before the refchild node.

When the newchild node has already existed in the DOM tree, it is removed before insertion.

Example

// create Element node    
SFXXMLElementPtr isbn = document.CreateElement("ISBN");
// add Text node to Element node   
isbn->AppendChild(SFXXMLNodePtr(document.CreateTextNode("4-7741-1616-5")));
// insert Element node   
book->InsertBefore(SFXXMLNodePtr(isbn), book->GetFirstChild());
 

Reference

SFXXMLNode::InsertBefore | SFXXMLNode

Description

If the Attribute node that match a specified name does not exist, this function is invalid .

	Note
	Qualified name(namespace prefix and local name) can be specified.

Example

// remove "dt:dt" Attribute node of "date" Element node 
date->RemoveAttribute("dt:dt");

Reference

SFXXMLElement::GetAttribute | SFXXMLElement::SetAttributeNode | SFXXMLElement::GetAttributeNode | SFXXMLElement::SetAttribute | SFXXMLElement::RemoveAttributeNode

Return value

Return the removed Attribute node (SFXXMLAttribute).

Example

// get "dt:dt" Attrubite node
SFXXMLAttributePtr atti = book->GetAttributeNode("dt:dt");
// remove this Attribite node from DOMNamedNodeMap
book->RemoveAttributeNode(atti);
// delete this node
delete atti;

Reference

SFXXMLAttribute | SFXXMLElement::GetAttribute | SFXXMLElement::SetAttributeNode | SFXXMLElement::GetAttributeNode | SFXXMLElement::SetAttribute | SFXXMLElement::RemoveAttribute

Return value

Reference

SFXXMLNode::RemoveChild| SFXXMLNode

Return value

Example

// create the name node   
SFXXMLElementPtr name = document.CreateElement("NAME");
// set a text to the name node
name->AppendChild(SFXXMLNodePtr(document.CreateTextNode("Cosmos")));
// replace the first child of book node with the name node
book->ReplaceChild(name, book->GetFirstChild());

Reference

SFXXMLNode::ReplaceChild| SFXXMLNode

Description

If the attribute with a specified name already exists, new value is set to this attribute.

	Note
	Qualified name(namespace prefix and local name) can be specified.

	Method to set the attribute value including an entity reference
	To set the attribute value including entity reference, specify the Attribute node(SFXXMLAttribute) that has any Text nodes(SFXXMLText) and a SFXXMLEntityReference node for an argument of the SFXXMLElement::SetAttributeNode function.

Reference

SFXXMLElement::SetAttributeNode | SFXXMLElement::GetAttribute | SFXXMLElement::GetAttributeNode | SFXXMLElement::HasAttribute | SFXXMLElement::HasAttributes | SFXXMLElement::RemoveAttribute | SFXXMLElement::RemoveAttributeNode

Return value

Description

If the Attribute node with the same name of specified Attribute node exists, it will be deleted and replaced with a specified Attribute node.

Example

// create isdn attribute (attribute value is set, too)
SFXXMLAttributePtr atti = document.CreateAttribute("isdn","4-7741-1616-5");
// add attribute to BOOK element
book->SetAttributeNode(atti);

Reference

SFXXMLElement::SetAttribute | SFXXMLElement::GetAttribute | SFXXMLElement::GetAttributeNode | SFXXMLElement::HasAttribute | SFXXMLElement::HasAttributes | SFXXMLElement::RemoveAttribute | SFXXMLElement::RemoveAttributeNode