QXmlInputSource Class

成员函数文档

QXmlInputSource::QXmlInputSource()

构建一个不包含任何数据的输入源。

另请参阅 setData()。

[explicit] QXmlInputSource::QXmlInputSource(QIODevice *dev)

构建一个输入源，并从设备dev 获取数据。如果dev 尚未打开，则以只读模式打开该文件。如果dev 为 0 或无法从设备读取数据，则该输入源将不包含任何数据。

另请参阅 setData()、fetchData() 和QIODevice 。

[virtual noexcept] QXmlInputSource::~QXmlInputSource()

析构函数。

[virtual] QString QXmlInputSource::data() const

返回输入源中包含的数据；如果输入源不包含任何数据，则返回空字符串。

另请参阅 setData()、QXmlInputSource() 和fetchData()。

[virtual] void QXmlInputSource::fetchData()

该函数从构造时设置的设备中读取更多数据。如果输入源中已经包含数据，该函数会先删除这些数据。

如果该对象在构造时未指定要读取数据的设备，或者该函数无法从设备获取更多数据，则调用此函数后，该对象将不包含任何数据。

有两种情况会由其他函数调用隐式地执行数据获取：在创建对象时（以便对象在有可用数据时初始化一些数据），以及在调用 `next()` 时（如果数据已用完）。

如果您使用next()，通常无需使用此函数。

另请参阅 data()、next() 和QXmlInputSource()。

[virtual protected] QString QXmlInputSource::fromRawData(const QByteArray &data, bool beginning = false)

该函数从data 读取XML文件，并尝试识别其编码。它将原始数据data 转换为QString ，并返回该结果。它会尽最大努力为XML文件获取正确的编码。

如果beginning 为 true，则该函数会假定数据位于新 XML 文档的开头，并查找编码声明；如果beginning 为 false，则使用从先前调用中确定的编码对原始数据进行转换。

[virtual] QChar QXmlInputSource::next()

返回输入源中的下一个字符。如果该函数到达可用数据的末尾，则返回 QXmlInputSource::EndOfData。如果在此之后调用 next()，它将通过调用fetchData() 尝试获取更多数据。 如果调用 `fetchData()` 返回了新数据，则本函数返回该数据的首个字符；否则，返回 `QXmlInputSource::EndOfDocument`。

诸如QXmlSimpleReader 之类的读取器会假设，如果该函数返回 QXmlInputSource::EndOfDocument，则表示已到达 XML 文档的末尾，并会检查所提供的输入是否格式正确。因此，在重写此函数时，务必确保复制此行为。

另请参阅 reset()、fetchData()、QXmlSimpleReader::parse() 以及QXmlSimpleReader::parseContinue()。

[virtual] void QXmlInputSource::reset()

该函数将next()所使用的位置设置为data()返回的数据开头。如果您希望将该输入源用于多次解析，此功能将非常有用。

另请参阅 next()。

[virtual] void QXmlInputSource::setData(const QString &dat)

将输入源的数据设置为dat 。

如果输入源中已包含数据，则该函数会先删除这些数据。

另请参阅 data()。

[virtual] void QXmlInputSource::setData(const QByteArray &dat)

数据dat 在被赋值之前，已通过正确的文本编解码器进行处理。