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

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

__NOTOC__

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

Класс QDomCharacterData представляет общие строки в DOM. Далее...

 #include <QDomCharacterData>

Наследует QDomNode.

От него унаследованы QDomComment and QDomText.

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

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

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

• QDomCharacterData ()
• QDomCharacterData ( const QDomCharacterData & x )
• void appendData ( const QString & arg )
• QString data () const
• void deleteData ( unsigned long offset, unsigned long count )
• void insertData ( unsigned long offset, const QString & arg )
• uint length () const
• QDomNode::NodeType nodeType () const
• void replaceData ( unsigned long offset, unsigned long count, const QString & arg )
• void setData ( const QString & v )
• QString substringData ( unsigned long offset, unsigned long count )
• QDomCharacterData & operator= ( const QDomCharacterData & x )

• 66 открытых функций унаследованных от QDomNode

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

Класс QDomCharacterData представляет общие строки в DOM.

Символьные данные в XML представляются в виде общих строк. Более специализированные версии этого класса - QDomText, QDomComment и QDomCDATASection.

Значение строки можно устанавливать с помощью функции setData() и извлекать с помощью data(). Вы можете получить подстроку посредством substringData(). Дополнительные данные могут быть добавлены в конец с помощью appendData() или вставлены фукнцией insertData(). Части строки можно удалить с помощью фукнции deleteData() или заменить посредством replaceData(). Длину строки можно определить фукнцией length().

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

Смотрите также QDomText, QDomComment и QDomCDATASection.

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

[править]

QDomCharacterData::QDomCharacterData ()

Создает пустой объект символьных данных.

[править]

QDomCharacterData::QDomCharacterData ( const QDomCharacterData & x )

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

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

[править]

void QDomCharacterData::appendData ( const QString & arg )

Присоединяет строку arg к сохраненной.

[править]

QString QDomCharacterData::data () const

Возаращает хранящуюся в объекте строку.

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

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

[править]

void QDomCharacterData::deleteData ( unsigned long offset, unsigned long count )

Удаляет подстроку длиной count, начиная с позиции offset.

[править]

void QDomCharacterData::insertData ( unsigned long offset, const QString & arg )

Вставляет строку arg в сохраненную, начиная с позиции offset.

[править]

uint QDomCharacterData::length () const

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

[править]

QDomNode::NodeType QDomCharacterData::nodeType () const

Возвращает тип узла, которому принадлежит строка (т.е. TextNode, CDATASectionNode, CommentNode или CharacterDataNode). Для нулевого узла возвращается CharacterDataNode.

[править]

void QDomCharacterData::replaceData ( unsigned long offset, unsigned long count, const QString & arg )

Замещает подстроку длиной count, начиная с позиции offset, строкой arg.

[править]

void QDomCharacterData::setData ( const QString & v )

Устанавливает значение строки как v.

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

[править]

QString QDomCharacterData::substringData ( unsigned long offset, unsigned long count )

Возвращает подстроку длиной count, начиная с позиции offset.

[править]

QDomCharacterData & QDomCharacterData::operator= ( const QDomCharacterData & x )

Прикрепляет x к текущему объекту.

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