Класс QDomNamedNodeMap

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

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

Примечание: Все функции в этом классе являются повторно входящими.

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

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

Обратите внимание, что QDomNamedNodeMap не наследуется от QDomNodeList. QDomNamedNodeMaps не обеспечивают конкретный порядок узлов. Хотя узлы в 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.