QDomNamedNodeMap Class
Die Klasse QDomNamedNodeMap enthält eine Sammlung von Knoten, auf die über den Namen zugegriffen werden kann. Mehr...
Kopfzeile: | #include <QDomNamedNodeMap> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Xml) target_link_libraries(mytarget PRIVATE Qt6::Xml) |
qmake: | QT += xml |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QDomNamedNodeMap ist Teil von XML Classes.
Hinweis: Alle Funktionen in dieser Klasse sind reentrant.
Öffentliche Funktionen
QDomNamedNodeMap() | |
QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap) | |
~QDomNamedNodeMap() | |
bool | contains(const QString &name) const |
int | count() const |
bool | isEmpty() const |
QDomNode | item(int index) const |
int | length() const |
QDomNode | namedItem(const QString &name) const |
QDomNode | namedItemNS(const QString &nsURI, const QString &localName) const |
QDomNode | removeNamedItem(const QString &name) |
QDomNode | removeNamedItemNS(const QString &nsURI, const QString &localName) |
QDomNode | setNamedItem(const QDomNode &newNode) |
QDomNode | setNamedItemNS(const QDomNode &newNode) |
int | size() const |
bool | operator!=(const QDomNamedNodeMap &other) const |
QDomNamedNodeMap & | operator=(const QDomNamedNodeMap &other) |
bool | operator==(const QDomNamedNodeMap &other) const |
Detaillierte Beschreibung
Beachten Sie, dass QDomNamedNodeMap nicht von QDomNodeList erbt. QDomNamedNodeMaps bieten keine spezifische Knotenreihenfolge. Obwohl auf Knoten in einer QDomNamedNodeMap über einen Ordnungsindex zugegriffen werden kann, dient dies lediglich dazu, eine bequeme Aufzählung des Inhalts einer QDomNamedNodeMap zu ermöglichen, und impliziert nicht, dass das DOM eine Ordnung der Knoten vorgibt.
Die QDomNamedNodeMap wird an drei Stellen verwendet:
- QDomDocumentType::entities() gibt eine Abbildung aller in der DTD beschriebenen Entitäten zurück.
- QDomDocumentType::notations() gibt eine Abbildung aller in der DTD beschriebenen Notationen zurück.
- QDomNode::attributes() gibt eine Abbildung aller Attribute eines Elements zurück.
Die Elemente in der Map werden durch den Namen identifiziert, den QDomNode::name() zurückgibt. Knoten werden mit namedItem(), namedItemNS() oder item() abgerufen. Neue Knoten werden mit setNamedItem() oder setNamedItemNS() eingefügt und mit removeNamedItem() oder removeNamedItemNS() entfernt. Verwenden Sie contains(), um zu sehen, ob ein Element mit dem angegebenen Namen in der benannten Knotenkarte vorhanden ist. Die Anzahl der Elemente wird von length() zurückgegeben.
Terminologie: In dieser Klasse werden die Begriffe "Element" und "Knoten" synonym verwendet.
Dokumentation der Mitgliedsfunktionen
QDomNamedNodeMap::QDomNamedNodeMap()
Konstruiert eine leere benannte Knotenkarte.
QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap)
Konstruiert eine Kopie von namedNodeMap.
[noexcept]
QDomNamedNodeMap::~QDomNamedNodeMap()
Zerstört das Objekt und gibt seine Ressourcen frei.
bool QDomNamedNodeMap::contains(const QString &name) const
Gibt true
zurück, wenn die Karte einen Knoten namens name enthält; andernfalls wird false
zurückgegeben.
Hinweis: Diese Funktion berücksichtigt nicht das Vorhandensein von Namespaces. Verwenden Sie namedItemNS(), um zu prüfen, ob die Map einen Knoten mit einem bestimmten Namespace-URI und -Namen enthält.
int QDomNamedNodeMap::count() const
Diese Funktion wird aus Gründen der Qt-API-Konsistenz bereitgestellt. Sie ist äquivalent zu length().
bool QDomNamedNodeMap::isEmpty() const
Gibt true
zurück, wenn die Map leer ist; andernfalls false
. Diese Funktion wird aus Gründen der Konsistenz der Qt-API bereitgestellt.
QDomNode QDomNamedNodeMap::item(int index) const
Ruft den Knoten an der Position index ab.
Dies kann verwendet werden, um über die Karte zu iterieren. Beachten Sie, dass die Knoten in der Karte willkürlich geordnet sind.
Siehe auch length().
int QDomNamedNodeMap::length() const
Gibt die Anzahl der Knoten in der Karte zurück.
Siehe auch item().
QDomNode QDomNamedNodeMap::namedItem(const QString &name) const
Gibt den Knoten mit dem Namen name zurück.
Wenn die Karte der benannten Knoten keinen solchen Knoten enthält, wird null node zurückgegeben. Der Name eines Knotens ist der Name, der von QDomNode::nodeName() zurückgegeben wird.
Siehe auch setNamedItem() und namedItemNS().
QDomNode QDomNamedNodeMap::namedItemNS(const QString &nsURI, const QString &localName) const
Gibt den Knoten zurück, der mit dem lokalen Namen localName und dem Namespace URI nsURI verbunden ist.
Wenn die Karte keinen solchen Knoten enthält, wird null node zurückgegeben.
Siehe auch setNamedItemNS() und namedItem().
QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)
Entfernt den Knoten namens name aus der Karte.
Die Funktion gibt den entfernten Knoten oder ein null node zurück, wenn die Karte keinen Knoten namens name enthielt.
Siehe auch setNamedItem(), namedItem(), und removeNamedItemNS().
QDomNode QDomNamedNodeMap::removeNamedItemNS(const QString &nsURI, const QString &localName)
Entfernt den Knoten mit dem lokalen Namen localName und dem Namespace URI nsURI aus der Map.
Die Funktion gibt den entfernten Knoten oder ein null node zurück, wenn die Map keinen Knoten mit dem lokalen Namen localName und dem Namespace URI nsURI enthielt.
Siehe auch setNamedItemNS(), namedItemNS(), und removeNamedItem().
QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)
Fügt den Knoten newNode in die benannte Knotenkarte ein. Der von der Karte verwendete Name ist der Knotenname von newNode, wie er von QDomNode::nodeName() zurückgegeben wird.
Wenn der neue Knoten einen bestehenden Knoten ersetzt, d.h. die Map einen Knoten mit demselben Namen enthält, wird der ersetzte Knoten zurückgegeben.
Siehe auch namedItem(), removeNamedItem(), und setNamedItemNS().
QDomNode QDomNamedNodeMap::setNamedItemNS(const QDomNode &newNode)
Fügt den Knoten newNode in die Karte ein. Wenn bereits ein Knoten mit demselben Namespace-URI und demselben lokalen Namen in der Map vorhanden ist, wird er durch newNode ersetzt. Wenn der neue Knoten einen vorhandenen Knoten ersetzt, wird der ersetzte Knoten zurückgegeben.
Siehe auch namedItemNS(), removeNamedItemNS(), und setNamedItem().
int QDomNamedNodeMap::size() const
Diese Funktion wird aus Gründen der Qt-API-Konsistenz bereitgestellt. Sie ist äquivalent zu length().
bool QDomNamedNodeMap::operator!=(const QDomNamedNodeMap &other) const
Gibt true
zurück, wenn other und diese benannte Knotenkarte nicht gleich sind; andernfalls wird false
zurückgegeben.
QDomNamedNodeMap &QDomNamedNodeMap::operator=(const QDomNamedNodeMap &other)
Weist other dieser benannten Knotenkarte zu.
bool QDomNamedNodeMap::operator==(const QDomNamedNodeMap &other) const
Gibt true
zurück, wenn other und diese benannte Knotenkarte gleich sind; andernfalls wird false
zurückgegeben.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.