QDomEntityReference Class

The QDomEntityReference class represents an XML entity reference. More...

Header: #include <QDomEntityReference>
CMake: find_package(Qt6 REQUIRED COMPONENTS Xml)
target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake: QT += xml
Inherits: QDomNode

Note: All functions in this class are reentrant.

Public Functions

QDomEntityReference()
QDomEntityReference(const QDomEntityReference &entityReference)
QDomNode::NodeType nodeType() const
QDomEntityReference &operator=(const QDomEntityReference &other)

Detailed Description

A QDomEntityReference object may be inserted into the DOM tree when an entity reference is in the source document, or when the user wishes to insert an entity reference.

Note that character references and references to predefined entities are expanded by the XML processor so that characters are represented by their Unicode equivalent rather than by an entity reference.

Moreover, the XML processor may completely expand references to entities while building the DOM tree, instead of providing QDomEntityReference objects.

If it does provide such objects, then for a given entity reference node, it may be that there is no entity node representing the referenced entity; but if such an entity exists, then the child list of the entity reference node is the same as that of the entity node. As with the entity node, all descendants of the entity reference are read-only.

For further information about the Document Object Model see Level 1 and Level 2 Core. For a more general introduction of the DOM implementation see the QDomDocument documentation.

Member Function Documentation

QDomEntityReference::QDomEntityReference()

Constructs an empty entity reference. Use QDomDocument::createEntityReference() to create a entity reference with content.

QDomEntityReference::QDomEntityReference(const QDomEntityReference &entityReference)

Constructs a copy of entityReference.

The data of the copy is shared (shallow copy): modifying one node will also change the other. If you want to make a deep copy, use cloneNode().

QDomNode::NodeType QDomEntityReference::nodeType() const

Returns EntityReference.

QDomEntityReference &QDomEntityReference::operator=(const QDomEntityReference &other)

Assigns other to this entity reference.

The data of the copy is shared (shallow copy): modifying one node will also change the other. If you want to make a deep copy, use cloneNode().