Qt:Документация 4.3.2/qdomnamednodemap
Материал из Wiki.crossplatform.ru
| Внимание: Актуальная версия перевода документации находится здесь |
__NOTOC__
|
Главная · Все классы · Основные классы · Классы по группам · Модули · Функции |
[править] Описание класса QDomNamedNodeMap
[модуль QtXml ]
Класс QDomNamedNodeMap содержит коллекцию узлов, которые могут быть доступны по имени. Далее...
#include <QDomNamedNodeMap>Примечание: Все функции в классе реентерабельны.
[править] Открытые функции
- QDomNamedNodeMap ()
- QDomNamedNodeMap ( const QDomNamedNodeMap & n )
- ~QDomNamedNodeMap ()
- bool contains ( const QString & name ) const
- int count () const
- bool isEmpty () const
- QDomNode item ( int index ) const
- uint length () const
- QDomNode namedItem ( const QString & name ) const
- QDomNode namedItemNS ( const QString & nsURI, const QString & localName ) const
- QDomNode removeNamedItem ( const QString & name )
- QDomNode removeNamedItemNS ( const QString & nsURI, const QString & localName )
- QDomNode setNamedItem ( const QDomNode & newNode )
- QDomNode setNamedItemNS ( const QDomNode & newNode )
- int size () const
- bool operator!= ( const QDomNamedNodeMap & n ) const
- QDomNamedNodeMap & operator= ( const QDomNamedNodeMap & n )
- bool operator== ( const QDomNamedNodeMap & n ) const
[править] Подробное описание
Класс 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.
Если словарь не содержит такого узла, возвращается null node.
Смотрите также 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 © 2007 Trolltech | Trademarks | Qt 4.3.2
|
