Класс QDomNamedNodeMap

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

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

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.