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

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

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

Класс QDomNodeList является списком объектов QDomNode. Далее...

 #include <QDomNodeList>

Примечание: Все функции в классе реентерабельны.

• Список всех членов включая унаследованные

[править] Открытые функции

• QDomNodeList ()
• QDomNodeList ( const QDomNodeList & n )
• ~QDomNodeList ()
• QDomNode at ( int index ) const
• int count () const
• bool isEmpty () const
• QDomNode item ( int index ) const
• uint length () const
• int size () const
• bool operator!= ( const QDomNodeList & n ) const
• QDomNodeList & operator= ( const QDomNodeList & n )
• bool operator== ( const QDomNodeList & n ) const

[править] Подробное описание

Класс QDomNodeList являетя списком объектов QDomNode.

Списки могут быть получены с помощью QDomDocument::elementsByTagName() и QDomNode::childNodes(). DOM требует, чтобы эти списки были "живыми": каждый раз, когда вы изменяете исходный документ, содержание списка будет обновляться.

Вы можете получить отдельный узел из списка с помощью item(). Количество элементов в списке можно узнать посредством length().

Для получения более подробной информации о Document Object Model смотрите http://www.w3.org/TR/REC-DOM-Level-1/ и http://www.w3.org/TR/DOM-Level-2-Core/. Для того, чтобы больше узнать о представлении DOM документа, смотрите документацию по QDomDocument.

Смотрите также QDomNode::childNodes() и QDomDocument::elementsByTagName().

[править] Описание функций-членов

[править]

QDomNodeList::QDomNodeList ()

Создает пустой список узлов.

[править]

QDomNodeList::QDomNodeList ( const QDomNodeList & n )

Создает копию n.

[править]

QDomNodeList::~QDomNodeList ()

Уничтожает объект и освобождает ресурсы.

[править]

QDomNode QDomNodeList::at ( int index ) const

Эта функция введена для обеспечения согласованности Qt API. Она эквивалентна item().

Если index отрицательный или если index >= length(), возвращается нулевой узел (т.е. узел, у которого QDomNode::isNull() возвращает true).

[править]

int QDomNodeList::count () const

Эта функция введена для обеспечения согласованности Qt API. Она эквивалентна length().

[править]

bool QDomNodeList::isEmpty () const

Возвращает true, если список не содержит элементов; в противном случае возвращается false. Эта функция введена для обеспечения согласованности Qt API.

[править]

QDomNode QDomNodeList::item ( int index ) const

Возвращает узел по индексу index.

Если index отрицательный или если index >= length(), возвращается нулевой узел (т.е. узел, у которого QDomNode::isNull() возвращает true).

Смотрите также length().

[править]

uint QDomNodeList::length () const

Возвращает количество узлов в списке.

[править]

int QDomNodeList::size () const

Эта функция введена для обеспечения согласованности Qt API. Она эквивалентна length().

[править]

bool QDomNodeList::operator!= ( const QDomNodeList & n ) const

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

[править]

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

Ассоциирует n с данным списком узлов.

[править]

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

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