Wiki
Главная  >  Qt  >  Qt 4.4.3
Задать вопрос на форуме... English version
  Главная · Все пространства имен · Все классы · Основные классы · Классы по группам · Модули · Функции

Описание класса QDomNode
[модуль QtXml]

Класс QDomNode является базовым классом для всех узлов в дереве DOM. Далее...

 #include <QDomNode>

От него наследуются QDomAttr, QDomCharacterData, QDomDocument, QDomDocumentFragment, QDomDocumentType, QDomElement, QDomEntity, QDomEntityReference, QDomNotation и QDomProcessingInstruction.

Замечание: все функции этого класса реентерабильны.

Открытые типы

  • enum EncodingPolicy { EncodingFromDocument, EncodingFromTextStream }
  • enum NodeType { ElementNode, AttributeNode, TextNode, CDATASectionNode, ..., CharacterDataNode }

Открытые функции

Связанные нечлены класса

  • QTextStream & operator<< ( QTextStream & str, const QDomNode & node )

Подробное описание

Класс QDomNode является базовым классом для всех узлов в дереве DOM.

Множество функций в DOM возвращают QDomNode.

Вы можете выяснить тип узла с помощью isAttr(), isCDATASection(), isDocumentFragment(), isDocument(), isDocumentType(), isElement(), isEntityReference(), isText(), isEntity(), isNotation(), isProcessingInstruction(), isCharacterData() и isComment().

QDomNode может быть преобразован в один из его подклассов, используя toAttr(), toCDATASection(), toDocumentFragment(), toDocument(), toDocumentType(), toElement(), toEntityReference(), toText(), toEntity(), toNotation(), toProcessingInstruction(), toCharacterData() или toComment(). Вы можете преобразовать узел в нулевой с помощью clear().

Копии объектов класса QDomNode разделяют свои данные используя явное разделение данных. Это означает, что изменение одного узла приведет к изменению всех копий. Это в особенности показательно в функциях, которые возвращают QDomNode, например, firstChild(). Вы можете использовать независимое (глубокое) копирование узла посредством cloneNode().

QDomNode может быть нулевым, в этом случае походя на нулевой указатель. При создании копии нулевого узла получится другой нулевой узел. Нулевой узел невозможно изменить, но возможно прикрепить другой, ненулевой, к данному объекту. В этом случае копия нулевого узла останется нулевой. Вы можете проверить, является ли узел нулевым, вызовом isNull(). Пустой конструктор QDomNode (или любого из классов-наследников) создает нулевой узел.

Узлы можно добавить с помощью insertBefore(), insertAfter() или appendChild(). Вы можете заменить один узел на другой с помощью replaceChild() и удалить узел посредством removeChild().

Для перебора узлов используйте firstChild() для получения первого узла-потомка (если такой существует) и nextSibling() для получения следующего. QDomNode также реализует функции lastChild(), previousSibling() и parentNode(). Для получения первого потомка с определенным именем используйте namedItem().

Для получения информации о том, имеет ли узел потомков, используйте hasChildNodes(), а для получения списка потомков - childNodes().

Имя узла и его значение (значение которого варьируется в зависимости от типа) возвращается функциями nodeName() и nodeValue(), соответственно. Тип узла можно узнать с помощью nodeType(). Значение узла устанавливается посредством setNodeValue().

Документ, которому принадлежит узел, можно получить с помощью ownerDocument().

Смежный узел QDomText может быть объединен с текущим в один узел посредством normalize().

Узлы QDomElement имеют атрибуты, которые можно получить через attributes().

Узлы QDomElement и QDomAttr могут поддерживать пространство имен, URI которого можно получить с помощью namespaceURI(). Их локальное имя доступно с помощью localName(), а префикс через prefix(). Префикс может быть установлен посредством setPrefix().

Вы можете записать XML-представление узла в текстовый поток с помощью save().

В представленном ниже примере ищется первый элемент в XML-документе и печатаются имена всех его непосредственных элементов-потомков.

 QDomDocument d;
 d.setContent(someXML);
 QDomNode n = d.firstChild();
 while (!n.isNull()) {
     if (n.isElement()) {
         QDomElement e = n.toElement();
         cout << "Element name: " << e.tagName() << endl;
         break;
     }
     n = n.nextSibling();
 }

Для получения дополнительной информации о Document Object Model смотрите спецификации Уровень 1 и Уровень 2. Для того, чтобы больше узнать о реализации DOM, смотрите документацию по QDomDocument.

Описание типов-членов

enum QDomNode::EncodingPolicy

Это перечисление устанавливает, как QDomNode::save() определяет кодировку при сериализации.

КонстантаЗначениеОписание
QDomNode::EncodingFromDocument1Кодировка определяется из документа.
QDomNode::EncodingFromTextStream2Кодировка определяется из QTextStream.

Смотрите также перегруженную функцию save(), которая учитывает EncodingPolicy.

Данное перечисление было введено в Qt 4.3.

enum QDomNode::NodeType

Перечисление определяет типы узлов:

КонстантаЗначениеОписание
QDomNode::ElementNode1 
QDomNode::AttributeNode2 
QDomNode::TextNode3 
QDomNode::CDATASectionNode4 
QDomNode::EntityReferenceNode5 
QDomNode::EntityNode6 
QDomNode::ProcessingInstructionNode7 
QDomNode::CommentNode8 
QDomNode::DocumentNode9 
QDomNode::DocumentTypeNode10 
QDomNode::DocumentFragmentNode11 
QDomNode::NotationNode12 
QDomNode::BaseNode21Объект QDomNode, т.е. не подкласс QDomNode.
QDomNode::CharacterDataNode22 

Описание функций-членов

QDomNode::QDomNode ()

Создаёт нулевой узел.

QDomNode::QDomNode ( const QDomNode & n )

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

Данные в копиях общие (поверхностное копирование): изменение одного узла повлечет за собой изменение другого. Если вы хотите использовать глубокое копирование, воспользуйтесь cloneNode().

QDomNode::~QDomNode ()

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

QDomNode QDomNode::appendChild ( const QDomNode & newChild )

Присоединяет узел newChild в качестве последнего потомка к текущему.

Если newChild является потомком другого узла, то его предок изменяется на текущий узел. Если newChild узел является потомком данного узла, изменяется его позиция в списке потомков.

Если newChild является QDomDocumentFragment, все потомки фрагмента удаляются из него и присоединяются к текущему узлу.

Если newChild является QDomElement и текущий узел является QDomDocument, уже имеющим такой элемент в качестве потомка, newChild не будет добавлен, пустой узел будет возвращен.

При вызове этой функции у нулевого узла (созданного, например, с помощью конструктора по умолчанию) ничего не произойдет.

Спецификация DOM запрещает вставку узлов атрибутов, но из-за исторических соображений QDom позволяет это.

Смотрите также insertBefore(), insertAfter(), replaceChild() и removeChild().

QDomNamedNodeMap QDomNode::attributes () const

Возвращает словарь всех атрибутов. Атрибуты предусмотрены только для объектов QDomElement.

Изменение атрибутов в словаре приведет к изменению их и непосредственно в объекте QDomNode.

QDomNodeList QDomNode::childNodes () const

Возвращает список всех непосредственных узлов-потомков.

Наиболее часто вы будете пользоваться этой функцией с объектом QDomElement.

Например, если XML-документ выглядит следующим образом:

 <body>
 <h1>Heading</h1>
 <p>Hello <b>you</b></p>
 </body>

То список узлов-потомков элемента "body" будет состоять из узла, созданного тегом &lt;h1&gt;, и узла, созданного тегом &lt;p&gt;.

Узлы в списке не являются копиями; поэтому изменение узлов в списке приведет и к изменению их в самом объекте.

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

void QDomNode::clear ()

Конвертирует узел в нулевой; если узел не был нулевым, его содержимое удаляется.

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

QDomNode QDomNode::cloneNode ( bool deep = true ) const

Создает глубокую (не поверхностную) копию объекта QDomNode.

Если deep равен true, клонирование происходит рекурсивно, что означает, что все потомки узла будут скопированы подобным же образом. Если deep равен false, будет скопирован только текущий узел, узлы-потомки скопированы не будут.

int QDomNode::columnNumber () const

Для узлов, созданных с помощью QDomDocument::setContent(), эта функция возвращает номер столбца в XML-документе, где он был проанализирован. В противном случае возвращает -1.

Эта функция была введена в Qt 4.1.

Смотрите также lineNumber() и QDomDocument::setContent().

QDomNode QDomNode::firstChild () const

Возвращает первого потомка узла. Если такового нет, возвращается нулевой узел. Изменение возвращенного узла приведет и к изменению узла в дереве документа.

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

QDomElement QDomNode::firstChildElement ( const QString & tagName = QString() ) const

Возвращает первого потомка с именем тега tagName, если tagName не пуст; в противном случае возвращает первого потомка элемента. Если таких узлов не обнаружено, возвращается нулевой элемент.

Смотрите также lastChildElement(), previousSiblingElement() и nextSiblingElement().

bool QDomNode::hasAttributes () const

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

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

bool QDomNode::hasChildNodes () const

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

QDomNode QDomNode::insertAfter ( const QDomNode & newChild, const QDomNode & refChild )

Вставляет узел newChild после refChild. refChild должен быть непосредственным потомком текущего узла. Если refChild является нулевым, тогда newChild присоединяется в качестве последнего потомка.

Если newChild является потомком другого узла, то его предок изменяется на текущий узел. Если newChild узел является потомком данного узла, изменяется его позиция в списке потомков.

Если newChild является QDomDocumentFragment, тогда потомки этого фрагмента удаляются из него и вставляются после refChild.

Возвращает новую ссылку на newChild в случае успешного завершения или нулевой узел в случае неудачи.

Спецификация DOM запрещает вставку узлов атрибутов, но из-за исторических соображений QDom позволяет это.

Смотрите также insertBefore(), replaceChild(), removeChild() и appendChild().

QDomNode QDomNode::insertBefore ( const QDomNode & newChild, const QDomNode & refChild )

Вставляет узел newChild перед узлом-потомком refChild. refChild должен быть непосредственным потомком текущего узла. Если refChild является нулевым, тогда newChild присоединяется в качестве первого потомка.

Если newChild является потомком другого узла, то его предок изменяется на текущий узел. Если newChild узел является потомком данного узла, изменяется его позиция в списке потомков.

Если newChild является QDomDocumentFragment, тогда потомки этого фрагмента удаляются из него и вставляются до refChild.

Возвращает новую ссылку на newChild в случае успешного завершения или нулевой узел в случае неудачи.

Спецификация DOM запрещает вставку узлов атрибутов, но из-за исторических соображений QDom позволяет это.

Смотрите также insertAfter(), replaceChild(), removeChild() и appendChild().

bool QDomNode::isAttr () const

Возвращает true, если узел является атрибутом; в противном случае возвращает false.

Если эта функция возвращает true, это не значит, что данный объект является QDomAttribute; вы можете получить QDomAttribute с помощью toAttribute().

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

bool QDomNode::isCDATASection () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomCDATASection; вы можете получить QDomCDATASection с помощью toCDATASection().

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

bool QDomNode::isCharacterData () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomCharacterData; вы можете получить QDomCharacterData с помощью toCharacterData().

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

bool QDomNode::isComment () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomComment; вы можете получить QDomComment с помощью toComment().

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

bool QDomNode::isDocument () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomDocument; вы можете получить QDomDocument с помощью toDocument().

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

bool QDomNode::isDocumentFragment () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomDocumentFragment; вы можете получить QDomDocumentFragment с помощью toDocumentFragment().

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

bool QDomNode::isDocumentType () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomDocumentType; вы можете получить QDomDocumentType с помощью toDocumentType().

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

bool QDomNode::isElement () const

Возвращает true, если узел является элементом; в противном случае возвращает false.

Если эта функция возвращает true, это не значит, что данный объект является QDomElement; вы можете получить QDomElement с помощью toElement().

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

bool QDomNode::isEntity () const

Возвращает true, если узел является сущностью; в противном случае возвращает false.

Если эта функция возвращает true, это не значит, что данный объект является QDomEntity; вы можете получить QDomEntity с помощью toEntity().

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

bool QDomNode::isEntityReference () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomEntityReference; вы можете получить QDomEntityReference с помощью toEntityReference().

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

bool QDomNode::isNotation () const

Возвращает true, если узел является нотацией; в противном случае возвращает false.

Если эта функция возвращает true, это не значит, что данный объект является QDomNotation; вы можете получить QDomNotation с помощью toNotation().

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

bool QDomNode::isNull () const

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

bool QDomNode::isProcessingInstruction () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomProcessingInstruction; вы можете получить QProcessingInstruction with toProcessingInstruction().

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

bool QDomNode::isSupported ( const QString & feature, const QString & version ) const

Возвращает true, если в реализации DOM имеется функция feature и эта функциональность поддерживается узлом в текущей версии version; в противном случает возвращает false.

Смотрите также QDomImplementation::hasFeature().

bool QDomNode::isText () const

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

Если эта функция возвращает true, это не значит, что данный объект является QDomText; вы можете получить QDomText с помощью toText(().

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

QDomNode QDomNode::lastChild () const

Возвращается последний потомок узла. Если такового нет, возвращается нулевой узел. Изменение возвращенного узла приведет и к изменению узла в дереве документа.

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

QDomElement QDomNode::lastChildElement ( const QString & tagName = QString() ) const

Возвращает последний элемент с именем тега tagName, если tagName не является пустым; в противном случае возвращается первый потомок. Если таких узлов не обнаружено, возвращается нулевой элемент.

Смотрите также firstChildElement(), previousSiblingElement() и nextSiblingElement().

int QDomNode::lineNumber () const

Для узлов, созданных с помощью QDomDocument::setContent(), эта функция возвращает номер строки в XML-документе, куда узел был помещен. В противном случае возвращает -1.

Эта функция была введена в Qt 4.1.

Смотрите также columnNumber() и QDomDocument::setContent().

QString QDomNode::localName () const

Если узел использует пространство имен, данная функция возвращает локальное имя узла; в противном случае возвращается пустая строка.

Только ElementNode или AttributeNode могут работать с пространствами имён. Причем оно должно быть определено при создании; невозможно добавить пространство имен позже.

QDomDocument::createAttributeNS()

Смотрите также prefix(), namespaceURI() и QDomDocument::createElementNS().

QDomNode QDomNode::namedItem ( const QString & name ) const

Возвращает первого потомка текущего узла, имя nodeName() которого равно name.

Если непосредственных потомков нет, возвращается нулевой узел.

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

QString QDomNode::namespaceURI () const

Возвращает URI пространства имен данного узла или пустую строку, если URI нет.

Только ElementNode или AttributeNode могут работать с пространствами имён. URI пространства имен должен быть определен на момент создания и не может быть изменен позже.

QDomDocument::createAttributeNS()

Смотрите также prefix(), localName() и QDomDocument::createElementNS().

QDomNode QDomNode::nextSibling () const

Возвращает следующий соседний элемент в дереве документа. Изменение возвращенного узла приведет и к изменению узла в дереве документа.

Если у вас есть XML:

 <h1>Heading</h1>
 <p>The text...</p>
 <h2>Next heading</h2>

и текущий QDomNode представляет тег <p>, nextSibling() вернет узел, представляющий тег <h2>.

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

QDomElement QDomNode::nextSiblingElement ( const QString & tagName = QString() ) const

Возвращает следующий соседний элемент в дереве документа с именем tagName, если tagName не является пустым; в противном случае возвращается следующий элемент с любым именем. Если таких элементов не существует, возвращается нулевой элемент.

Смотрите также firstChildElement(), previousSiblingElement() и lastChildElement().

QString QDomNode::nodeName () const

Возвращает имя узла.

Значение имени зависит от подкласса:

ИмяЗначение
QDomAttrИмя атрибута
QDomCDATASectionСтрока "#cdata-section"
QDomCommentСтрока "#comment"
QDomDocumentСтрока "#document"
QDomDocumentFragmentСтрока "#document-fragment"
QDomDocumentTypeИмя типа документа
QDomElementИмя тега
QDomEntityИмя сущности
QDomEntityReferenceИмя сущности, на которою ссылаются
QDomNotationИмя нотации
QDomProcessingInstructionЦель инструкции обработки
QDomTextСтрока "#text"

Замечание: Эта функция не учитывает наличия пространств имен при обработке имен узлов элементов и атрибутов. В результате возвращаемое имя может содержать любой префикс пространства имен, который мог быть представлен. Чтобы получить имя элемента или атрибута, используйте localName(); чтобы получить префикс пространства имен, используйте namespaceURI().

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

NodeType QDomNode::nodeType () const

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

Смотрите также toAttr(), toCDATASection(), toDocumentFragment(), toDocument(), toDocumentType(), toElement(), toEntityReference(), toText(), toEntity(), toNotation(), toProcessingInstruction(), toCharacterData() и toComment().

QString QDomNode::nodeValue () const

Возвращает значение узла.

Содержание возвращаемого значения зависит от подкласса узла:

ИмяЗначение
QDomAttrЗначение атрибута
QDomCDATASectionСодержание сегмента CDATA
QDomCommentКомментарий
QDomProcessingInstructionДанные инструкции обработки
QDomTextТекст

Все остальные подклассы не имеют значения, при вызове этой функции будет возвращена пустая строка.

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

void QDomNode::normalize ()

Вызов normalize() для элемента преобразует всех его потомков в стандартную форму. Это означает, что смежные объекты QDomText будут объединены с соседними в один объект (узлы QDomCDATASection не могут быть объединены).

QDomDocument QDomNode::ownerDocument () const

Возвращает документ, которому принадлежит данный узел.

QDomNode QDomNode::parentNode () const

Возвращает узел предка. Если у узла нет предков, возвращается нулевой узел (т.е. узел, для которого функция isNull() возвращает true).

QString QDomNode::prefix () const

Возвращает префикс пространства имен данного узла или пустую строку, если такового нет.

Только ElementNode или AttributeNode могут работать с пространствами имён. Префикс пространства имен должен быть определен на момент создания. Если узел был создан с префиксом, вы можете изменить его позже с помощью setPrefix().

Если вы создаёте элемент или атрибут с помощью QDomDocument::createElement() или QDomDocument::createAttribute(), префикс будет пустой строкой. Если вы используете QDomDocument::createElementNS() или QDomDocument::createAttributeNS(), префикс не будет пустой строкой; но он может быть пустой строкой, если имя не имеет префикса.

QDomDocument::createElementNS() QDomDocument::createAttributeNS()

Смотрите также setPrefix(), localName() и namespaceURI().

QDomNode QDomNode::previousSibling () const

Возвращает предыдущий соседний элемент в дереве документа. Изменение возвращенного узла приведет и к изменению узла в дереве документа.

Например, если у вас есть такой XML:

 <h1>Heading</h1>
 <p>The text...</p>
 <h2>Next heading</h2>

и текущий QDomNode представляет тег &lt;p&gt;, то previousSibling() вернет узел, представляющий тег &lt;h1&gt;.

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

QDomElement QDomNode::previousSiblingElement ( const QString & tagName = QString() ) const

Возвращает предыдущий соседний элемент в дереве документа с именем тега tagName, если tagName не является пустым; в противном случае возвращается предыдущий элемент с любым именем. Если таких элементов не существует, возвращается нулевой элемент.

Смотрите также firstChildElement(), nextSiblingElement() и lastChildElement().

QDomNode QDomNode::removeChild ( const QDomNode & oldChild )

Удаляет oldChild из списка потомков. oldChild должен являться непосредственным потомком текущего узла.

Возвращается ссылка на oldChild при удачной попытке удаления или ссылка на нулевой узел в случае провала.

Смотрите также insertBefore(), insertAfter(), replaceChild() и appendChild().

QDomNode QDomNode::replaceChild ( const QDomNode & newChild, const QDomNode & oldChild )

Замещает oldChild новым newChild. oldChild должен являться непосредственным потомком текущего узла.

Если newChild является потомком другого узла, то его предок изменяется на текущий узел. Если newChild узел является потомком данного узла, изменяется его позиция в списке потомков.

Если newChild является QDomDocumentFragment, тогда oldChild замещается всеми потомками фрагмента.

Возвращает ссылку на oldChild в случае успеха или ссылку на нулевой узел в случае неудачи.

Смотрите также insertBefore(), insertAfter(), removeChild() и appendChild().

void QDomNode::save ( QTextStream & str, int indent ) const

Записывает XML-представление узла и всех его потомков в поток str. Эта функция использует indent для определения величины отступа для подэлементов.

Если узел является узлом документа, кодировка потока str устанавливается по инструкции обработки с именем "xml", являющейся XML-декларацией, если таковая определена, в противном случае используется UTF-8. XML-декларация не является, по сути, инструкцией обработки, но её поведение подобно таковой по историческим причинам. Если узел не является узлом документа, используется кодировка потока.

Если документ содержит недопустимые символы XML или символы, которые не могут быть закодированы в данной кодировке, результат будет неопределен.

void QDomNode::save ( QTextStream & str, int indent, EncodingPolicy encodingPolicy ) const

Это перегруженная функция, предоставленная для удобства.

Если encodingPolicy является QDomNode::EncodingFromDocument, то данная функция работает как save(QTextStream &str, int indent).

Если encodingPolicy является EncodingFromTextStream и текущий узел является узлом документа, то данная функция работает как save(QTextStream &str, int indent) с той только особенностью, что кодировка определяется потоком str.

Если документ содержит недопустимые символы XML или символы, которые не могут быть закодированы в данной кодировке, результат будет неопределен.

Эта функция была введена в Qt 4.2.

void QDomNode::setNodeValue ( const QString & v )

Устанавливает значение узла в v.

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

void QDomNode::setPrefix ( const QString & pre )

Если узел имеет префикс пространства имён, данная функция меняет его на pre. В противном случае функция ничего не делает.

Только ElementNode или AttributeNode могут работать с пространствами имён. Префикс пространства имён должен быть определён во время создания объекта; невозможно добавить префикс позже.

QDomDocument::createElementNS() QDomDocument::createAttributeNS()

Смотрите также prefix(), localName() и namespaceURI().

QDomAttr QDomNode::toAttr () const

Преобразует QDomNode в QDomAttr. Если узел не является атрибутом, возвращённый объект будет нулевым.

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

QDomCDATASection QDomNode::toCDATASection () const

Преобразует QDomNode в QDomCDATASection. Если узел не является секцией CDATA, возвращённый объект будет нулевым.

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

QDomCharacterData QDomNode::toCharacterData () const

Преобразует QDomNode в QDomCharacterData. Если узел не является текстовым узлом, возвращённый объект будет нулевым.

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

QDomComment QDomNode::toComment () const

Преобразует QDomNode в QDomComment. Если узел не является нотацией, возвращённый объект будет нулевым.

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

QDomDocument QDomNode::toDocument () const

Преобразует QDomNode в QDomDocument. Если узел не является документом, возвращённый объект будет нулевым.

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

QDomDocumentFragment QDomNode::toDocumentFragment () const

Преобразует QDomNode в QDomDocumentFragment. Если узел не является фрагментом документа, возвращённый объект будет нулевым.

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

QDomDocumentType QDomNode::toDocumentType () const

Преобразует QDomNode в QDomDocumentType. Если узел не является типом документа, возвращённый объект будет нулевым.

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

QDomElement QDomNode::toElement () const

Преобразует QDomNode в QDomElement. Если узел не является элементом, возвращённый объект будет нулевым.

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

QDomEntity QDomNode::toEntity () const

Преобразует QDomNode в QDomEntity. Если узел не является сущностью, возвращённый объект будет нулевым.

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

QDomEntityReference QDomNode::toEntityReference () const

Преобразует QDomNode в QDomEntityReference. Если узел не является ссылкой на сущность, возвращённый объект будет нулевым.

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

QDomNotation QDomNode::toNotation () const

Преобразует QDomNode в QDomNotation. Если узел не является нотацией, возвращенный объект будет нулевым.

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

QDomProcessingInstruction QDomNode::toProcessingInstruction () const

Преобразует QDomNode в QDomProcessingInstruction. Если узел не является инструкцией обработки, возвращенный объект будет нулевым.

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

QDomText QDomNode::toText () const

Преобразует QDomNode в QDomText. Если узел не является текстовым, возвращенный объект будет нулевым.

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

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

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

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

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

Данные в копиях общие (поверхностное копирование): изменение одного узла повлечет за собой изменение другого. Если вы хотите использовать глубокое копирование, воспользуйтесь cloneNode().

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

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

Любой экземпляр класса QDomNode выступает в качестве ссылки на изначальную структуру данных в QDomDocument. Данный тест проверяет, являются ли оба представления ссылками на один и тот же основополагающий узел. Например:

 QDomDocument document;
 QDomElement element1 = document.documentElement();
 QDomElement element2 = element1;

Оба узла (QDomElement является подклассом QDomNode) ссылаются на корневой элемент документа, а element1 == element2 вернет true. С другой стороны:

 QDomElement element3 = document.createElement("MyElement");
 QDomElement element4 = document.createElement("MyElement");

Даже если оба узла являются пустыми элементами с одним именем, element3 == element4 вернет false, так как они ссылаются на два различных узла в изначальной структуре данных.

Связанные нечлены класса

QTextStream & operator<< ( QTextStream & str, const QDomNode & node )

Это перегруженная функция, предоставленная для удобства.

Записывает XML-представление узла node и всех его потомков в поток str.

Copyright © 2008 Nokia Торговые марки
Qt 4.4.3
Попытка перевода Qt документации.
Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык...
Люди внесшие вклад в перевод: Команда переводчиков