本页内容

QDomCharacterData Class

QDomCharacterData 类表示 DOM 中的通用字符串。更多内容...

头文件: #include <QDomCharacterData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Xml)
target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake: QT += xml
继承自: QDomNode
继承自:

QDomComment 以及QDomText

注意:该类中的所有函数均为可重入的。

公共函数

QDomCharacterData()
QDomCharacterData(const QDomCharacterData &characterData)
void appendData(const QString &arg)
QString data() const
void deleteData(unsigned long offset, unsigned long count)
void insertData(unsigned long offset, const QString &arg)
int length() const
QDomNode::NodeType nodeType() const
void replaceData(unsigned long offset, unsigned long count, const QString &arg)
void setData(const QString &data)
QString substringData(unsigned long offset, unsigned long count)
QDomCharacterData &operator=(const QDomCharacterData &other)

详细说明

XML 中使用的字符数据指定了一个通用的数据字符串。该类的更专门的版本包括QDomText 、QDomComment 和QDomCDATASection 。

数据字符串通过setData() 设置,并通过data() 检索。您可以使用substringData() 检索数据字符串的一部分。可以使用appendData() 追加额外数据,或使用insertData() 插入额外数据。可以使用deleteData() 删除数据字符串的一部分,或使用replaceData() 替换数据字符串的一部分。length() 返回数据字符串的长度。

包含此字符数据的节点的节点类型由nodeType() 返回。

另请参阅 QDomText 、QDomComment 和QDomCDATASection 。

成员函数文档

QDomCharacterData::QDomCharacterData()

创建一个空的字符数据对象。

QDomCharacterData::QDomCharacterData(const QDomCharacterData &characterData)

创建characterData 的副本。

该副本的数据是共享的(浅拷贝):修改其中一个节点也会导致另一个节点发生变化。若需进行深拷贝,请使用cloneNode()。

void QDomCharacterData::appendData(const QString &arg)

将字符串arg 追加到存储的字符串末尾。

QString QDomCharacterData::data() const

返回此对象中存储的字符串。

如果该节点是null node ,则将返回一个空字符串。

另请参阅 setData()。

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

从位置offset 开始,删除长度为count 的子字符串。

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

将字符串arg 插入到存储字符串的offset 位置处。

int QDomCharacterData::length() const

返回存储字符串的长度。

QDomNode::NodeType QDomCharacterData::nodeType() const

返回该对象所引用的节点的类型(即TextNode 、CDATASectionNode 、CommentNode 或CharacterDataNode )。对于null node ,返回CharacterDataNode 。

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

将从位置offset 开始、长度为count 的子字符串替换为字符串arg 。

void QDomCharacterData::setData(const QString &data)

将该对象的字符串设置为data 。

另请参阅 data()。

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

返回从位置offset 开始、长度为count 的子字符串。

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

将other 赋值给该字符数据。

该复制的数据是共享的(浅拷贝):修改一个节点也会改变另一个节点。若要进行深拷贝,请使用cloneNode()。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.