Описание класса QDomNamedNodeMap [модуль QtXml]
Класс QDomNamedNodeMap содержит коллекцию узлов, которые могут быть доступны по имени. Далее...
#include <QDomNamedNodeMap> Замечание: все функции этого класса реентерабильны.
Открытые функции
Подробное описание
Класс QDomNamedNodeMap содержит коллекцию узлов, которые могут быть доступны по имени.
Помните о том, что QDomNamedNodeMap не унаследован от QDomNodeList. QDomNamedNodeMaps не обеспечивает специальную сортировку узлов. Хотя узлы в QDomNamedNodeMap могут быть получены по порядковому индексу, это реализовано просто для того, чтобы удобно было перебирать содержимое QDomNamedNodeMap, и это не означает, что DOM определяет порядок узлов.
QDomNamedNodeMap используется в трёх местах:
- QDomDocumentType::entities() возвращает словарь всех сущностей, описанных в DTD.
- QDomDocumentType::notations() возвращает словарь всех нотаций, описанных в DTD.
- 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
Эта функция создана из соображений согласованности Qt API. Она является эквивалентом length().
bool QDomNamedNodeMap::isEmpty () const
Возвращает true, если словарь пуст; в противном случае возвращает false. Эта функция создана из соображений согласованности Qt API.
QDomNode QDomNamedNodeMap::item ( int index ) const
Находит узел на позиции index.
Это может быть использовано для итеративного обхода словаря. Помните, что узлы в словаре не упорядочены.
Смотрите также length().
uint 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
Эта функция создана из соображений согласованности Qt API. Она является эквивалентом 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.
Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) |
Торговые марки |
Qt 4.5.3 |
|