matlab.io.xml.dom.DOMWriter 类

命名空间: matlab.io.xml.dom

串行化 XML 文档的写入器

自 R2021a 起

描述

使用 matlab.io.xml.dom.DOMWriter 类的对象创建串行化 XML 文档的写入器。

matlab.io.xml.dom.DOMWriter 类是一个 handle 类。

类属性

`ConstructOnLoad`	`true`
`HandleCompatible`	`true`

有关类属性的信息，请参阅类属性。

创建对象

描述

writer = matlab.io.xml.dom.DOMWriter() 创建一个写入器来串行化 matlab.io.xml.dom.Document 对象。请使用 Configuration 属性指定写入器选项。

示例

属性

全部展开

`Configuration` — 写入器选项
`matlab.io.xml.dom.WriterConfiguration` 对象

写入选项，指定为 matlab.io.xml.dom.WriterConfiguration 对象。

属性：

`GetAccess`	`public`
`SetAccess`	`immutable`
`Transient`	`true`
`NonCopyable`	`true`

数据类型:

方法

全部展开

公共方法

write

write(thisWriter,domDoc,fileWriter) 使用指定的文件写入器编写从指定的 DOM 文档串行化的 XML 标记。

将 domDoc 指定为 matlab.io.xml.dom.Document 对象，将 fileWriter 指定为 matlab.io.xml.dom.FileWriter 对象。

使用此方法将非 XML 文本与串行化的 XML 文本混合在一起。

writeToFile

writeToFile(thisWriter,domDoc,filePath) 串行化指定的文档，并将得到的编码为 UTF-8 的 XML 标记存储在指定路径上的文件中。

writeToFile(thisWriter,domDoc,filePath,encoding) 使用指定的编码，而不是 UTF-8。

将 domDoc 指定为 matlab.io.xml.dom.Document 对象，将 filePath 指定为字符串标量或字符向量。filePath 参量可以包含非 ASCII 字符。filePath 指定的文件必须是可写的。

使用此方法将 XML DOM 文档串行化为文件。

如果文件存储在远程位置，则 filePath 必须包含用以下格式指定的文件的完整路径：

scheme_name://path_to_file/my_file.ext

根据远程位置，scheme_name 可以是下表中的值之一。

远程位置	`scheme_name`
Amazon S3™	`s3`
Azure^® Blob 存储	`wasb`, `wasbs`
HDFS™	`hdfs`

有关详细信息，请参阅处理远程数据。

示例：'s3://bucketname/path_to_file/data.xml'

writeToString

xmlstr = writeToString(thisWriter,domDoc) 串行化指定的文档，并将其以字符向量形式返回。

将 domDoc 指定为 matlab.io.xml.dom.Document 对象。

setNewLine

setNewLine(thisWriter,newLine) 指定一个或多个字符以在串行化输出中开始新行。

可将 newLine 指定为以下值之一：

'' - 换行符（默认值）
newline - 换行符
char(13) - 回车符
[char(13) newline] - 回车符后跟换行符

getNewLine

newLine = getNewLine(thisWriter) 返回此写入器在串行化输出中用于开始新行的一个或多个字符。

示例

全部折叠

将 XML 文档写入文件

打开实时脚本

使用 matlab.io.xml.dom.DOMWriter 对象将 XML 文档写入文件。

将 XML 文档创建为 matlab.io.xml.dom.Document 对象。

import matlab.io.xml.dom.*
docNode = Document("root_element");
docRootNode = getDocumentElement(docNode);
weekdays = ["Mon" "Tue" "Wed" "Thu" "Fri"];
weekdaysElement = createElement(docNode,"weekdays");
for i=1:5
    dayElement = createElement(docNode,"day");
    appendChild(dayElement,createTextNode(docNode,weekdays(i)));
    appendChild(weekdaysElement,dayElement);
end
appendChild(docRootNode,weekdaysElement);

创建一个写入器来串行化该 XML 文档。

xmlFileName = "weekdays.xml";
writer = matlab.io.xml.dom.DOMWriter;

将 XML 文档保存到文件中。

writeToFile(writer,docNode,xmlFileName);

版本历史记录

在 R2021a 中推出

另请参阅

matlab.io.xml.dom.Document | matlab.io.xml.dom.WriterConfiguration | matlab.io.xml.dom.FileWriter