Класс QDomNamedNodeMap

Класс QDomNamedNodeMap содержит коллекцию узлов, к которым можно получить доступ по имени. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Подробное описание

Обратите внимание, что QDomNamedNodeMap не наследуется от QDomNodeList. QDomNamedNodeMap не обеспечивают никакого специфического упорядочивания узлов. Хотя к узлам в QDomNamedNodeMap можно получить доступ по порядковому индексу, это просто позволяет удобно перечислить содержимое QDomNamedNodeMap, и не подразумевает, что DOM указывает порядок узлов.

QDomNamedNodeMap используется в трех местах:

1. QDomDocumentType::entities() возвращает карту всех сущностей, описанных в DTD.
2. QDomDocumentType::notations() возвращает карту всех обозначений, описанных в DTD.
3. QDomNode::attributes() возвращает карту всех атрибутов элемента.

Элементы в карте идентифицируются по имени, которое возвращает QDomNode::name(). Узлы извлекаются с помощью namedItem(), namedItemNS() или item(). Новые узлы вставляются с помощью setNamedItem() или setNamedItemNS(), а удаляются с помощью removeNamedItem() или removeNamedItemNS(). Используйте contains(), чтобы проверить наличие элемента с данным именем в карте узлов. Количество элементов возвращается функцией length().

Терминология: в этом классе мы используем «элемент» и «узел» взаимозаменяемо.

Документация по функциям-членам

QDomNamedNodeMap::QDomNamedNodeMap(const QDomNamedNodeMap &n)

Создает копию n.

QDomNamedNodeMap::QDomNamedNodeMap()

Создает пустую карту узлов по имени.

QDomNamedNodeMap &QDomNamedNodeMap::operator=(const QDomNamedNodeMap &n)

Присваивает n этой карте узлов по имени.

QDomNamedNodeMap::~QDomNamedNodeMap()

Уничтожает объект и освобождает его ресурсы.

bool QDomNamedNodeMap::contains(const QString &name) const

Возвращает true если карта содержит узел с именем name; в противном случае возвращает false.

Примечание: Эта функция не учитывает наличие пространств имен. Используйте namedItemNS(), чтобы проверить, содержит ли карта узел с указанным URI пространства имен и именем.

int QDomNamedNodeMap::count() const

Эта функция предоставляется для обеспечения согласованности API Qt. Она эквивалентна length().

bool QDomNamedNodeMap::isEmpty() const

Возвращает true если карта пуста; в противном случае возвращает false. Эта функция предоставляется для обеспечения согласованности API Qt.

QDomNode QDomNamedNodeMap::item(int index) const

Возвращает узел в позиции index.

Это можно использовать для итерации по карте. Обратите внимание, что узлы в карте упорядочены произвольно.

См. также length().

int QDomNamedNodeMap::length() const

Возвращает количество узлов в карте.

См. также item().

QDomNode QDomNamedNodeMap::namedItem(const QString &name) const

Возвращает узел с именем name.

Если в карте узлов по имени такого узла нет, возвращается пустой узел. Имя узла — это имя, возвращаемое QDomNode::nodeName().

См. также setNamedItem() и namedItemNS().

QDomNode QDomNamedNodeMap::namedItemNS(const QString &nsURI, const QString &localName) const

Возвращает узел, связанный с локальным именем localName и URI пространства имен nsURI.

Если в карте такого узла нет, возвращается пустой узел.

См. также setNamedItemNS() и namedItem().

QDomNode QDomNamedNodeMap::removeNamedItem(const QString &name)

Удаляет узел с именем name из карты.

Функция возвращает удаленный узел или пустой узел, если в карте не было узла с именем name.

См. также setNamedItem(), namedItem() и removeNamedItemNS().

QDomNode QDomNamedNodeMap::removeNamedItemNS(const QString &nsURI, const QString &localName)

Удаляет узел с локальным именем localName и URI пространства имен nsURI из карты.

Функция возвращает удаленный узел или пустой узел, если в карте не было узла с локальным именем localName и URI пространства имен nsURI.

См. также setNamedItemNS(), namedItemNS() и removeNamedItem().

QDomNode QDomNamedNodeMap::setNamedItem(const QDomNode &newNode)

Вставляет узел newNode в карту именованных узлов. Имя, используемое картой, — это имя узла newNode, возвращаемое методом QDomNode::nodeName().

Если новый узел заменяет существующий узел (т. е. карта содержит узел с таким же именем), возвращается заменённый узел.

См. также namedItem(), removeNamedItem() и setNamedItemNS().

QDomNode QDomNamedNodeMap::setNamedItemNS(const QDomNode &newNode)

Вставляет узел newNode в карту. Если в карте уже существует узел с тем же пространством имён URI и тем же локальным именем, он заменяется узлом newNode. Если новый узел заменяет существующий узел, возвращается заменённый узел.

См. также namedItemNS(), removeNamedItemNS() и setNamedItem().

int QDomNamedNodeMap::size() const

Эта функция предоставляется для обеспечения совместимости API Qt. Она эквивалентна методу length().

bool QDomNamedNodeMap::operator!=(const QDomNamedNodeMap &n) const

Возвращает true если n и эта карта именованных узлов не равны; в противном случае возвращает false.

bool QDomNamedNodeMap::operator==(const QDomNamedNodeMap &n) const

Возвращает true если n и эта карта именованных узлов равны; в противном случае возвращает false.