An instance of this class represents an element inside an xsl:template class. More...
#include <ElemTemplateElement.hpp>
Inheritance diagram for ElemTemplateElement:
Collaboration diagram for ElemTemplateElement:
NodeList
that contains all children of this node. More...NamedNodeMap
containing the attributes of this node (if it is an Element
) or null
otherwise.Document
object associated with this node. More...newChild
before the existing child node refChild
. More...oldChild
with newChild
in the list of children, and returns the oldChild
node. More...oldChild
from the list of children, and returns it. More...Text
nodes in the full depth of the sub-tree underneath this Node
, including attribute nodes, into a "normal" form where only markup (e.g., tags, comments, processing instructions, CDATA sections, and entity references) separates Text
nodes, i.e., there are no adjacent Text
nodes. More...null
if it is unspecified. More...null
if it is unspecified.Attr
node by name. More...NodeList
of all descendant elements with a given tag name, in the order in which they would be encountered in a preorder traversal of the Element
tree. More...Attr
node by local name and namespace URI. More...NodeList
of all the Element
s with a given local name and namespace URI in the order in which they would be encountered in a preorder traversal of the Document
tree, starting from this node. More...An instance of this class represents an element inside an xsl:template class.
It has a single "execute" method which is expected to perform the given action on the result tree.
|
|
Construct a template element instance.
constructionContext | context when object consructed |
stylesheetTree | owning stylesheet |
name | name of the element |
lineNumber | line in the XSLT file where the element occurs |
columnNumber | column index in the XSLT file where the element occurs |
xslToken | an integer representing the type of instance. |
|
|
Add a child to the child list.
DOMException |
newChild | child node to add |
Reimplemented from XalanElement.
|
Append a child.
theParent - the new value for the parent.
Reimplemented in ElemApplyImport.
|
Given an xsl token type, determine whether or not a child of that type is allowed.
This is so derived types can determine whether a particular type of child is allowed for the instance. It is called from appendChildElem().
The default is to allow no types (no children)
xslToken |
The xsl token value of the child.
|
Reimplemented in ElemApplyTemplates, ElemAttribute, ElemAttributeSet, ElemCallTemplate, ElemChoose, ElemComment, ElemPI, and ElemText.
|
Take the contents of a template element, process it, and convert it to a string.
executionContext | The current execution context |
sourceTree | primary source tree |
sourceNode | current source node context |
mode | current mode |
|
Returns a duplicate of this node.
This function serves as a generic copy constructor for nodes.
The duplicate node has no parent (
parentNode
returns null
.).
Cloning an Element
copies all attributes and their
values, including those generated by the XML processor to represent
defaulted attributes, but this method does not copy any text it contains
unless it is a deep clone, since the text is contained in a child
Text
node. Cloning any other type of node simply returns a
copy of this node.
deep |
If true , recursively clone the subtree under the
specified node; if false , clone only the node itself (and
its attributes, if it is an Element ).
|
Reimplemented from XalanElement.
|
|
Perform a query if needed, and call transformChild for each child.
executionContext | The current execution context |
stylesheetTree | The owning stylesheet tree. |
xslInstruction | The stylesheet element context (deprecated -- I do not think we need this). |
template | The owning template context. |
sourceTree | The input source tree. |
sourceNodeContext | The current source node context. |
mode | The current mode. |
selectPattern | The XPath with which to perform the selection. |
xslToken | The current XSLT instruction (deprecated -- I do not think we want this). |
selectStackFrameIndex | stack frame context for executing the select statement |
|
Perform a query if needed, and call transformChild for each child.
executionContext | The current execution context |
stylesheetTree | The owning stylesheet tree. |
xslInstruction | The stylesheet element context (deprecated -- I do not think we need this). |
template | The owning template context. |
sourceTree | The input source tree. |
sourceNodeContext | The current source node context. |
mode | The current mode. |
selectPattern | The XPath with which to perform the selection. |
xslToken | The current XSLT instruction (deprecated -- I do not think we want this). |
selectStackFrameIndex | stack frame context for executing the select statement |
|
Throw a template element runtime error.
(Note: should we throw a SAXException instead?)
msg | Description of the error that occurred |
|
Execute the element's primary function.
Subclasses of this function may recursively execute down the element tree.
executionContext | The current execution context |
sourceTree | input source tree |
sourceNode | current context node |
mode | current mode |
Reimplemented in ElemApplyImport, ElemApplyTemplates, ElemAttribute, ElemAttributeSet, ElemCallTemplate, ElemChoose, ElemComment, ElemCopy, ElemCopyOf, ElemDecimalFormat, ElemElement, ElemEmpty, ElemExtensionCall, ElemFallback, ElemForEach, ElemIf, ElemLiteralResult, ElemMessage, ElemNumber, ElemPI, ElemParam, ElemTemplate, ElemTextLiteral, ElemUse, ElemValueOf, and ElemVariable.
|
Process the children of a template.
processor | XSLT processor instance |
sourceTree | input source tree |
sourceNode | current context node |
mode | current mode |
|
Set a flag indicating construction of the element is completed.
|
Retrieves an attribute value by name.
name | The name of the attribute to retrieve. |
Attr
value as a string, or the empty string if
that attribute does not have a specified or default value.
Reimplemented from XalanElement.
|
Retrieves an attribute value by local name and namespace URI.
namespaceURI | The namespace URI of the attribute to retrieve. |
localName | The local name of the attribute to retrieve. |
Attr
value as a string, or an empty string if
that attribute does not have a specified or default value.
Reimplemented from XalanElement.
|
Retrieves an Attr
node by name.
name |
The name (nodeName ) of the attribute to retrieve.
|
Attr
node with the specified name (nodeName
) or
null
if there is no such attribute.
Reimplemented from XalanElement.
|
Retrieves an Attr
node by local name and namespace URI.
namespaceURI | The namespace URI of the attribute to retrieve. |
localName | The local name of the attribute to retrieve. |
Attr
node with the specified attribute local
name and namespace URI or null
if there is no such attribute.
Reimplemented from XalanElement.
|
Gets a NamedNodeMap
containing the attributes of this node (if it is an Element
) or null
otherwise.
Reimplemented from XalanElement.
|
Gets a NodeList
that contains all children of this node.
If there
are no children, this is a NodeList
containing no nodes.
The content of the returned NodeList
is "live" in the sense
that, for instance, changes to the children of the node object that
it was created from are immediately reflected in the nodes returned by
the NodeList
accessors; it is not a static snapshot of the
content of the node. This is true for every NodeList
,
including the ones returned by the getElementsByTagName
method.
Reimplemented from XalanElement.
|
Get the column offset where the element occurs in the xsl file.
|
|
Returns a NodeList
of all descendant elements with a given tag name, in the order in which they would be encountered in a preorder traversal of the Element
tree.
Caller is responsible for deleting the XalanNodeList instance.
name | The name of the tag to match on. The special value "*" matches all tags. |
Element
nodes.
Reimplemented from XalanElement.
|
Returns a NodeList
of all the Element
s with a given local name and namespace URI in the order in which they would be encountered in a preorder traversal of the Document
tree, starting from this node.
Caller is responsible for deleting the XalanNodeList instance.
namespaceURI | The namespace URI of the elements to match on. The special value "*" matches all namespaces. |
localName | The local name of the elements to match on. The special value "*" matches all local names. |
NodeList
object containing all the matched
Element
s.
Reimplemented from XalanElement.
|
Gets the first child of this node.
If there is no such node, this returns null
.
Reimplemented from XalanElement.
|
Get the first child.
|
Get the node's index.
Valid only if the owner document reports that the document is node-order indexed.
Reimplemented from XalanElement.
|
Gets the last child of this node.
If there is no such node, this returns null
.
Reimplemented from XalanElement.
|
Get the last child.
|
Get the line number where the element occurs in the xsl file.
|
Returns the local part of the qualified name of this node.
For nodes created with a DOM Level 1 method, such as
createElement
from the Document
interface,
it is null.
Reimplemented from XalanElement.
|
Retrieve a namespace corresponding to a prefix.
This assumes that the PrevixResolver hold's its own namespace context, or is a namespace context itself.
prefix | Prefix to resolve |
Reimplemented from PrefixResolver.
|
Get the namespace for a given prefix.
prefix | The prefix to search for |
fReportError | If true, and exception will be thrown to report the error. |
|
Get the namespace URI of this node, or null
if it is unspecified.
This is not a computed value that is the result of a namespace lookup based on an examination of the namespace declarations in scope. It is merely the namespace URI given at creation time.
For nodes of any type other than ELEMENT_NODE
and
ATTRIBUTE_NODE
and nodes created with a DOM Level 1 method,
such as createElement
from the Document
interface, this is always null
.
Reimplemented from XalanElement.
|
Get the namespaces handler for this element.
Reimplemented in ElemElement, and ElemLiteralResult.
|
Gets the node immediately following this node.
If there is no such node, this returns null
.
Reimplemented from XalanElement.
|
Get the next sibling.
|
Reimplemented from XalanElement.
|
|
|
Gets the Document
object associated with this node.
This is also
the Document
object used to create new nodes. When this
node is a Document
or a DocumentType
which is not used with any Document
yet, this is
null
.
Reimplemented from XalanElement.
|
Gets the parent of this node.
All nodes, except Document
,
DocumentFragment
, and Attr
may have a parent.
However, if a node has just been created and not yet added to the tree,
or if it has been removed from the tree, a null
Node
is returned.
Reimplemented from XalanElement.
|
Get the parent node.
|
Get the namespace prefix of this node, or null
if it is unspecified.
Reimplemented from XalanElement.
|
Gets the node immediately preceding this node.
If there is no such node, this returns null
.
Reimplemented from XalanElement.
|
Get the previous sibling.
|
Retrieve the stylesheet from which this element comes.
|
The name of the element.
For example, in: <elementExample
id="demo"> ... </elementExample> , tagName
has
the value "elementExample"
. Note that this is
case-preserving in XML, as are all of the operations of the DOM.
Reimplemented from XalanElement.
|
|
Returns the character data of the node that implements this interface, according to the XSLT specification.
Reimplemented from XalanElement.
|
Get an integer representation of the element type.
|
This is a convenience method to allow easy determination of whether a node has any children.
true
if the node has any children,
false
if the node has no children.
Reimplemented from XalanElement.
|
Inserts the node newChild
before the existing child node refChild
.
If refChild
is null
,
insert newChild
at the end of the list of children.
If newChild
is a DocumentFragment
object,
all of its children are inserted, in the same order, before
refChild
. If the newChild
is already in the
tree, it is first removed. Note that a Node
that
has never been assigned to refer to an actual node is == null.
newChild | The node to insert. |
refChild | The reference node, i.e., the node before which the new node must be inserted. |
Reimplemented from XalanElement.
|
Append a child.
newChild | the new child to insert |
refChild |
the node before which to insert the new node
|
|
See if this is a xmlns attribute or in a non-XSLT.
attrName | qualified name of attribute |
atts | attribute list where the element comes from (not used at this time) |
which | index into the attribute list (not used at this time) |
Reimplemented in ElemLiteralResult.
|
See if this is a xmlns attribute, and, if so, process it.
attrName | qualified name of attribute |
atts | attribute list where the element comes from (not used at this time) |
which | index into the attribute list (not used at this time) |
Reimplemented in ElemLiteralResult.
|
Determine if the document is node-order indexed.
Reimplemented from XalanElement.
|
Validate that the string is an NCName.
s | name in question |
|
Tell if the string is whitespace.
string | string in question |
|
Puts all Text
nodes in the full depth of the sub-tree underneath this Node
, including attribute nodes, into a "normal" form where only markup (e.g., tags, comments, processing instructions, CDATA sections, and entity references) separates Text
nodes, i.e., there are no adjacent Text
nodes.
This can be used to ensure that the DOM view of a document is the same as if it were saved and re-loaded, and is useful when operations (such as XPointer lookups) that depend on a particular document tree structure are to be used.
Note: In cases where the document contains CDATASections
,
the normalize operation alone may not be sufficient, since XPointers do
not differentiate between Text
nodes and CDATASection
nodes.
Reimplemented from XalanElement.
|
|
Tell whether or not this is a xml:space attribute and, if so, process it.
aname | name of the attribute in question |
atts | attribute list that owns the attribute |
which | index of the attribute into the attribute list |
|
Tell whether or not this is a xml:space attribute and, if so, process it.
aname | name of the attribute in question |
atts | attribute list that owns the attribute |
which | index of the attribute into the attribute list |
|
Removes an attribute by name.
If the removed attribute
is known to have a default value, an attribute immediately appears
containing the default value as well as the corresponding namespace URI,
local name, and prefix when applicable.
To remove an attribute by local
name and namespace URI, use the removeAttributeNS
method.
name | The name of the attribute to remove. |
DOMException | NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. |
Reimplemented from XalanElement.
|
Removes an attribute by local name and namespace URI.
If the
removed attribute has a default value it is immediately replaced.
The replacing attribute has the same namespace URI and local name, as well as
the original prefix.
HTML-only DOM implementations do not need to
implement this method.
namespaceURI | The namespace URI of the attribute to remove. |
localName | The local name of the attribute to remove. |
DOMException | NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. |
Reimplemented from XalanElement.
|
Removes the specified attribute node.
If the removed Attr
has a default value it is immediately replaced. The replacing attribute
has the same namespace URI and local name, as well as the original prefix,
when applicable.
oldAttr |
The Attr node to remove from the attribute
list.
|
Attr
node that was removed.
DOMException |
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
NOT_FOUND_ERR: Raised if oldAttr is not an attribute
of the element.
|
Reimplemented from XalanElement.
|
Removes the child node indicated by oldChild
from the list of children, and returns it.
oldChild | The node being removed. |
Reimplemented from XalanElement.
|
Replaces the child node oldChild
with newChild
in the list of children, and returns the oldChild
node.
If newChild
is a DocumentFragment
object,
oldChild
is replaced by all of the DocumentFragment
children, which are inserted in the same order.
If the newChild
is already in the tree, it is first removed.
newChild | The new node to put in the child list. |
oldChild | The node being replaced in the list. |
Reimplemented from XalanElement.
|
Replace a child.
newChild | the new child to insert |
oldChild |
the child to be replaced
|
|
Adds a new attribute.
If an attribute with that name is already present
in the element, its value is changed to be that of the value parameter.
This value is a simple string, it is not parsed as it is being set. So
any markup (such as syntax to be recognized as an entity reference) is
treated as literal text, and needs to be appropriately escaped by the
implementation when it is written out. In order to assign an attribute
value that contains entity references, the user must create an
Attr
node plus any Text
and
EntityReference
nodes, build the appropriate subtree, and
use setAttributeNode
to assign it as the value of an
attribute.
name | The name of the attribute to create or alter. |
value | Value to set in string form. |
DOMException |
INVALID_CHARACTER_ERR: Raised if the specified name contains an
illegal character.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. |
Reimplemented from XalanElement.
|
Adds a new attribute.
If the given
namespaceURI
is null
or an empty string and the
qualifiedName
has a prefix that is "xml", the new attribute
is bound to the predefined namespace
"http://www.w3.org/XML/1998/namespace".
If an attribute with the same local name and namespace URI is already
present on the element, its prefix is changed to be the prefix part of the
qualifiedName
, and its value is changed to be the
value
parameter.
This value is a simple string, it is
not parsed as it is being set. So any markup (such as syntax to be
recognized as an entity reference) is treated as literal text, and
needs to be appropriately escaped by the implementation when it is
written out. In order to assign an attribute value that contains entity
references, the user must create a Attr
node plus any
Text
and EntityReference
nodes, build the
appropriate subtree, and use setAttributeNodeNS
or
setAttributeNode
to assign it as the value of an
attribute.
namespaceURI | The namespace URI of the attribute to create or alter. |
localName | The local name of the attribute to create or alter. |
value | The value to set in string form. |
DOMException |
INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an
illegal character.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. NAMESPACE_ERR: Raised if the qualifiedName is
malformed, if the qualifiedName has a prefix that is
"xml" and the namespaceURI is neither null
nor an empty string nor "http://www.w3.org/XML/1998/namespace", or
if the qualifiedName has a prefix that is "xmlns" but
the namespaceURI is neither null nor an
empty string, or if if the qualifiedName has a prefix
different from "xml" and "xmlns" and the namespaceURI
is null or an empty string.
|
Reimplemented from XalanElement.
|
Adds a new attribute.
If an attribute with that name (nodeName
) is already present
in the element, it is replaced by the new one.
newAttr |
The Attr node to add to the attribute list.
|
newAttr
attribute replaces an existing
attribute, the replaced
Attr
node is returned, otherwise null
is
returned.
DOMException |
WRONG_DOCUMENT_ERR: Raised if newAttr was created from a
different document than the one that created the element.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. INUSE_ATTRIBUTE_ERR: Raised if newAttr is already an
attribute of another Element object. The DOM user must
explicitly clone Attr nodes to re-use them in other
elements.
|
Reimplemented from XalanElement.
|
Adds a new attribute.
If an attribute with that local name and namespace URI is already present in the element, it is replaced by the new one.
newAttr |
The Attr node to add to the attribute list.
|
newAttr
attribute replaces an existing
attribute with the same local name and namespace URI,
the replaced Attr
node is
returned, otherwise null
is returned.
DOMException |
WRONG_DOCUMENT_ERR: Raised if newAttr was created from a
different document than the one that created the element.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. INUSE_ATTRIBUTE_ERR: Raised if newAttr is already an
attribute of another Element object. The DOM user must
explicitly clone Attr nodes to re-use them in other
elements.
|
Reimplemented from XalanElement.
|
Set the first child.
theChild - the new value for the first child.
|
Set the next sibling.
theSibling - the new value for the next sibling.
|
Sets the value of the node.
Any node which can have a nodeValue (
Reimplemented from XalanElement.
|
Set the parent node.
theParent - the new value for the parent.
|
Set the namespace prefix of this node.
Note that setting this attribute, when permitted, changes
the nodeName
attribute, which holds the qualified
name, as well as the tagName
and name
attributes of the Element
and Attr
interfaces, when applicable.
Note also that changing the prefix of an
attribute, that is known to have a default value, does not make a new
attribute with the default value and the original prefix appear, since the
namespaceURI
and localName
do not change.
prefix | The prefix of this node. |
DOMException |
INVALID_CHARACTER_ERR: Raised if the specified prefix contains
an illegal character.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly. NAMESPACE_ERR: Raised if the specified prefix is
malformed, if the specified prefix is "xml" and the
namespaceURI of this node is different from
"http://www.w3.org/XML/1998/namespace", if specified prefix is
"xmlns" and the namespaceURI is neither
null nor an empty string, or if the
localName is null .
|
Reimplemented from XalanElement.
|
Set the previous sibling.
theSibling - the new value for the previous sibling.
|
Tests whether the DOM implementation implements a specific feature and that feature is supported by this node.
feature |
The string of the feature to test. This is the same
name as what can be passed to the method hasFeature on
DOMImplementation .
|
version |
This is the version number of the feature to test. In
Level 2, version 1, this is the string "2.0". If the version is not
specified, supporting any version of the feature will cause the
method to return true .
|
true
if the specified feature is supported
on this node, false
otherwise.
Reimplemented from XalanElement.
|
Given an element and mode, find the corresponding template and process the contents.
executionContext | The current execution context |
stylesheetTree | The current Stylesheet object. |
xslInstruction | The calling element (deprecated -- I dont think we need this). |
template | The template to use if xsl:for-each, or null. |
sourceTree | The source DOM tree. |
selectContext | The selection context. |
child | The source context node. |
mode | The current mode, may be null. |
xslToken | ELEMNAME_APPLY_TEMPLATES, ELEMNAME_APPLY_IMPORTS, or ELEMNAME_FOREACH. |
|
Perform a query if needed, and call transformChild for each child.
executionContext | The current execution context |
stylesheetTree | The owning stylesheet tree. |
xslInstruction | The stylesheet element context (deprecated -- I do not think we need this). |
template | The owning template context. |
sourceTree | The input source tree. |
sourceNodeContext | The current source node context. |
mode | The current mode. |
selectPattern | The XPath with which to perform the selection. |
xslToken | The current XSLT instruction (deprecated -- I do not think we want this). |
selectStackFrameIndex | stack frame context for executing the select statement |
|
The documentation for this class was generated from the following file:
Doxygen and GraphViz are used to generate this API documentation from the Xalan-C header files.
![]() |
Xalan-C++ XSL Transformer Version 1.0 |
|