QDomNamedNodeMap Class
Die Klasse „QDomNamedNodeMap“ enthält eine Sammlung von Knoten, auf die über ihren Namen zugegriffen werden kann. Mehr...
| Header: | #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 der XML-Klassen.
Hinweis: Alle Funktionen 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 |
Ausführliche Beschreibung
Beachten Sie, dass QDomNamedNodeMap nicht von QDomNodeList erbt. QDomNamedNodeMaps bieten keine spezifische Knotenreihenfolge. Zwar kann auf Knoten in einer `QDomNamedNodeMap` über einen ordinalen Index zugegriffen werden, dies dient jedoch lediglich der bequemen Aufzählung des Inhalts einer `QDomNamedNodeMap` und bedeutet nicht, dass das DOM eine bestimmte Reihenfolge der Knoten vorschreibt.
Die `QDomNamedNodeMap` wird an drei Stellen verwendet:
- QDomDocumentType::entities() gibt eine Zuordnung aller in der DTD beschriebenen Entitäten zurück.
- QDomDocumentType::notations() gibt eine Zuordnung aller in der DTD beschriebenen Notationen zurück.
- QDomNode::attributes() gibt eine Zuordnung aller Attribute eines Elements zurück.
Elemente in der Zuordnung 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 prüfen, ob ein Element mit dem angegebenen Namen in der Abbildung des genannten Knotens enthalten ist. Die Anzahl der Elemente wird von „ length()“ zurückgegeben.
Terminologie: In dieser Klasse verwenden wir die Begriffe „Element“ und „Knoten“ synonym.
Dokumentation der Mitgliedsfunktionen
QDomNamedNodeMap::QDomNamedNodeMap()
Erstellt eine leere benannte Knotenzuordnung.
QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &namedNodeMap)
Erstellt eine Kopie von „ namedNodeMap “.
[noexcept] QDomNamedNodeMap::~QDomNamedNodeMap()
Löscht das Objekt und gibt dessen Ressourcen frei.
bool QDomNamedNodeMap::contains(const QString &name) const
Gibt „ true “ zurück, wenn die Map einen Knoten namens „ name “ enthält; andernfalls wird „ false “ zurückgegeben.
Hinweis: Diese Funktion berücksichtigt das Vorhandensein von Namespaces nicht. Verwenden Sie „ namedItemNS()“, um zu prüfen, ob die Map einen Knoten mit einer bestimmten Namespace-URI und einem bestimmten Namen enthält.
int QDomNamedNodeMap::count() const
Diese Funktion dient der Konsistenz der Qt-API. Sie entspricht der Funktion ` length()`.
bool QDomNamedNodeMap::isEmpty() const
Gibt „ true “ zurück, wenn die Map leer ist; andernfalls wird „ false “ zurückgegeben. Diese Funktion dient der Konsistenz der Qt-API.
QDomNode QDomNamedNodeMap::item(int index) const
Ruft den Knoten an der Position index ab.
Dies kann verwendet werden, um die Karte zu durchlaufen. Beachten Sie, dass die Knoten in der Karte willkürlich angeordnet sind.
Siehe auch length().
int QDomNamedNodeMap::length() const
Gibt die Anzahl der Knoten in der Map zurück.
Siehe auch „ item()“.
QDomNode QDomNamedNodeMap::namedItem(const QString &name) const
Gibt den Knoten namens „ name “ zurück.
Wenn die benannte Knoten-Map keinen solchen Knoten enthält, wird ein ` 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 dem lokalen Namen „ localName “ und der Namespace-URI „ nsURI “ zugeordnet ist.
Enthält die Map keinen solchen Knoten, wird ein null node zurückgegeben.
Siehe auch setNamedItemNS() und namedItem().
QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)
Entfernt den Knoten „ name “ aus der Map.
Die Funktion gibt den entfernten Knoten zurück oder einen „ null node “, falls die Map 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 der Namespace-URI „ nsURI “ aus der Map.
Die Funktion gibt den entfernten Knoten zurück oder einen ` null node `, falls die Map keinen Knoten mit dem lokalen Namen ` localName ` und der Namespace-URI ` nsURI` enthielt.
Siehe auch setNamedItemNS(), namedItemNS() und removeNamedItem().
QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)
Fügt den Knoten newNode in die benannte Knoten-Map ein. Der von der Map verwendete Name ist der Knotenname von newNode, wie er von QDomNode::nodeName() zurückgegeben wird.
Ersetzt der neue Knoten einen bereits vorhandenen Knoten, d. h., enthält die Map einen Knoten mit demselben Namen, 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 Map ein. Wenn in der Map bereits ein Knoten mit derselben Namespace-URI und demselben lokalen Namen vorhanden ist, wird dieser durch „ newNode “ ersetzt. Wenn der neue Knoten einen bestehenden Knoten ersetzt, wird der ersetzte Knoten zurückgegeben.
Siehe auch namedItemNS(), removeNamedItemNS() und setNamedItem().
int QDomNamedNodeMap::size() const
Diese Funktion dient der Konsistenz der Qt-API. Sie entspricht der Funktion „ length()“.
bool QDomNamedNodeMap::operator!=(const QDomNamedNodeMap &other) const
Gibt „ true “ zurück, wenn „ other “ und diese benannte Knotenzuordnung nicht identisch sind; andernfalls wird „ false “ zurückgegeben.
QDomNamedNodeMap &QDomNamedNodeMap::operator=(const QDomNamedNodeMap &other)
Weist dieser benannten Knotenkarte die Adresse „ other “ zu.
bool QDomNamedNodeMap::operator==(const QDomNamedNodeMap &other) const
Gibt „ true “ zurück, wenn „ other “ und diese benannte Knotenzuordnung identisch sind; andernfalls wird „ false “ zurückgegeben.
© 2026 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.
