Main Content

transform

类： matlab.io.xml.transform.Transformer
包： matlab.io.xml.transform

转换 XML 文档

自 R2021a 起

全页展开

语法

transform(transformer,input,stylesheet,output)
document = transform(transformer,input,stylesheet)
transform(transformer,input,output)
document = transform(transformer,input)

说明

transform(transformer,input,stylesheet,output) 使用 transformer 应用 stylesheet 来转换 input，并将结果存储在 output 指定的位置。

document = transform(transformer,input,stylesheet) 以 matlab.io.xml.dom.Document 对象形式返回结果。

transform(transformer,input,output) 要求输入文档包含用于指定样式表的处理指令，并将结果存储在 output 指定的位置。例如，以下位于 XML 文档开头的标记指定位于当前文件夹中名为 catalog.xsl 的样式表。

<?xml version="1.0" encoding="UTF-8"?>
 <?xml-stylesheet type="text/xsl" href="catalog.xsl"?>

document = transform(transformer,input) 要求输入文档包含用于指定样式表的处理指令，并以 matlab.io.xml.dom.Document 对象形式返回结果。

输入参数

全部展开

XML 文档转换器，指定为 matlab.io.xml.transform.Transformer 对象。

要转换的 XML，指定为以下值之一：

值用于指定
字符向量、字符串标量或 matlab.io.xml.transform.SourceFile 对象XML 文件路径
matlab.io.xml.transform.SourceString 对象XML 字符串
matlab.io.xml.dom.Document 或 matlab.io.xml.transform.SourceDocument 对象解析后的 XML 文档

要转换的 XML，指定为以下值之一：

值用于指定
字符向量、字符串标量或 matlab.io.xml.transform.StylesheetSourceFile 对象样式表文件路径
matlab.io.xml.transform.SourceString 对象XSL 标记
matlab.io.xml.dom.Document 或 matlab.io.xml.transform.StylesheetSourceDocument 对象解析后的文档
matlab.io.xml.transform.CompiledStylesheet 对象编译的样式表

存储转换后的输出的位置，指定为以下值之一：

值用于指定
字符向量、字符串标量或 matlab.io.xml.transform.ResultFile 对象文件路径
matlab.io.xml.transform.ResultString 对象结果字符串
matlab.io.xml.transform.ResultDocument 对象解析后的文档

输出参数

全部展开

转换结果，以 matlab.io.xml.dom.Document 对象形式返回。

示例

全部展开

打开实时脚本

此示例将包含国家/地区及其首都信息的 XML 标记转换为 XML 表。

该示例使用下列文件：

  • capitals.xml

<Countries>
    <Country><Name>Canada</Name><Capital>Ottawa</Capital></Country>
    <Country><Name>France</Name><Capital>Paris</Capital></Country>
    <Country><Name>Peru</Name><Capital>Lima</Capital></Country>
</Countries>

  • capitals.xsl

<?xml version="1.0"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
  <html>
  <body>
      <table>
      <tr>
        <th>Country</th>
        <th>Capital</th>
      </tr>
      <xsl:for-each select="Countries/Country">
        <tr>
          <td><xsl:value-of select="Name"/></td>
          <td><xsl:value-of select="Capital"/></td>
        </tr>
      </xsl:for-each>
    </table>
  </body>
  </html>
</xsl:template>

</xsl:stylesheet>

调用 transform 方法以使用 capitals.xsl 文件中的样式表转换 capitals.xml 中的 XML 标记，并将结果存储在 capitals.html 文件中。

import matlab.io.xml.transform.*
transform(Transformer,"capitals.xml","capitals.xsl","capitals.html");

在浏览器中打开 capitals.html。

web("capitals.html")

下面是 HTML 表：

打开实时脚本

要以 matlab.io.xml.dom.Document 对象形式返回转换结果，请提供输出参数，而不是将结果位置指定为输入参数。

import matlab.io.xml.transform.*
doc = transform(Transformer,"capitals.xml","capitals.xsl");
XSLT warning: The processor cannot use the HTML output method because the current extension output method does not support it. (Occurred in entity 'file:///tmp/Bdoc23a_2181783_970408/tpec052f27/matlab-ex76514650/capitals.xsl', at an unknown location.)

版本历史记录

在 R2021a 中推出

另请参阅

| | | | | | | | | | | |