Qt:Документация 4.3.2/qdomnamednodemap

Материал из Wiki.crossplatform.ru

Версия от 11:10, 6 ноября 2008; Root (Обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск
40px Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

Image:qt-logo.png

Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

Image:trolltech-logo.png

Содержание

[править] Описание класса QDomNamedNodeMap
[модуль QtXml ]

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

 #include <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

Эта функция создана из соображений согласованности 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