Класс QDomNamedNodeMap

Класс 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()

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

QDomNamedNodeMap::QDomNamedNodeMap(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.

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

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

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

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