QT QXmlStreamWriter

向右看齐 2022-10-18 15:58 21阅读 0赞

QXmlStreamWriter类提供了一个带有简单流API的XML编写器。

QXmlStreamWriter是QXmlStreamReader的对等体，用于编写XML。像它的相关类一样，它操作由setDevice()指定的QIODevice。该API简单而直接:对于您想要编写的每个XML标记或事件，编写器都提供一个专门的函数。

用writeStartDocument()开始文档，用writeEndDocument()结束文档。这将隐式关闭所有剩余的打开标记。  
      
    元素标记以writeStartElement()打开，然后是writeAttribute()或writeAttributes()，元素内容，然后是writeEndElement()。一个更短的形式writeEmptyElement()可用于编写空元素，后跟writeAttributes()。  
      
    元素内容由字符、实体引用或嵌套元素组成。它是用writecharcharacters()编写的，该方法还负责转义所有禁止的字符和字符序列、writeEntityReference()或随后对writeStartElement()的调用。一个方便的方法writeTextElement()可以用于编写只包含文本的终端元素。

下面的代码片段显示了用缩进编写格式化XML的类的基本用法:

QXmlStreamWriter stream(&output);
          stream.setAutoFormatting(true);
          stream.writeStartDocument();
          ...
          stream.writeStartElement("bookmark");
          stream.writeAttribute("href", "http://qt-project.org/");
          stream.writeTextElement("title", "Qt Project");
          stream.writeEndElement(); // bookmark
          ...
          stream.writeEndDocument();

QXmlStreamWriter负责命名空间的前缀，您所要做的就是在编写元素或属性时指定命名空间。如果必须遵循某些前缀，可以通过使用writeNamespace()或writeDefaultNamespace()手动声明名称空间来强制写入者使用它们。或者，您可以绕过流写入器的名称空间支持，而使用接受限定名称的重载方法。名称空间http://www.w3.org/XML/1998/namespace是隐式的，并映射到前缀xml。

流写入器可以通过向元素之间的空部分添加换行符和缩进来自动格式化生成的XML数据，使XML数据更易于人类阅读，并且对于大多数源代码管理系统来说更容易处理。这个特性可以用autoFormatting属性来打开，也可以用autoformatingindent属性来定制。  
      
    其他函数有writeCDATA()、writeComment()、writeProcessingInstruction()和writeDTD()。writeCurrentToken()支持XML流的链接。  
      
    默认情况下，QXmlStreamWriter以UTF-8编码XML。可以使用setCodec()强制执行不同的编码。  
      
    如果写入底层设备时发生错误，hasError()开始返回true，后续的写入将被忽略。  
      
    QXmlStream Bookmarks示例演示了如何使用流写入器编写以前由QXmlStreamReader读取的XML书签文件(XBEL)。