Main Content

本页采用了机器翻译。点击此处可查看英文原文。

mlreportgen.report.TextFile 类

命名空间: mlreportgen.report

文字档案报告器

自 R2023a 起

全页展开

描述

创建一个报告器来报告文本文件。

mlreportgen.report.TextFile 类是一个 handle 类。

类属性

HandleCompatible
true

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

创建对象

描述

示例

reporter = TextFile 根据默认模板创建一个空的 TextFile 报告对象。使用其属性来指定要报告的文本文件并指定报告选项。您必须指定要报告的文本文件名。向报告中添加一个空的 TextFile 报告对象（即未指定文件名的对象）会产生错误。

reporter = TextFile(filename) 创建一个 TextFile 报告器对象，并将 FileName 属性设置为 filename。将此报告器添加到报告中，无需任何进一步的修改，将文本文件内容添加到生成的报告中。使用报告器的属性来定制报告选项。

reporter = TextFile(p1,v1,p2,v2,...) 创建一个 TextFile 报告器并将属性 (p1,p2,...) 初始化为指定值 (v1,v2,...)。

属性

全部展开

文本文件的路径或名称，指定为字符向量。

示例: tf.FileName = "Name of File"

数据类型: char | string

指定是否将文件作为 DOM Paragraph 或 DOM Text 对象导入。当设置为 true 时，MATLAB® 会将文件作为 DOM Paragraph 对象导入。输入按照 ParaSep 属性设置的值分成段落。使用值为 DOM Paragraph 对象的 ParagraphFormatter 属性来格式化 DOM Paragraph 对象。如果该属性设置为 false，MATLAB 会将文本文件导入为 DOM Text 对象。使用值为 DOM Text 对象的 TextFormatter 属性来格式化 DOM Text 对象。

示例: 'ImportFileAsParagraph','false'

数据类型: logical

段落分隔符，指定为字符向量或字符串标量。使用此属性指定用于将输入分成段落的分隔符。您可以使用任意分隔符。例如，newline 在换行符处分隔输入文本，并将文本换行成段落。

示例: 'ParaSep','char(10)'

数据类型: char | string

如果 TextFile 报告器的 ImportFileAsParagraph 属性为 true，则报告器会将纯文本段落追加到此对象的副本之后，再将其追加到报告中。使用 mlreportgen.dom.Paragraph 对象属性通过设置默认段落的属性或用自定义段落替换默认段落来格式化纯文本段落。您添加到默认或替换段落的内容将显示在生成的报告内容之前。

示例: 'ParagraphFormatter.Color','red'

如果 TextFile 报告器的 ImportFileAsParagraph 属性为 false，则报告器会将纯文本内容追加到此对象的副本之后，再将其追加到报告中。使用 mlreportgen.dom.Text 对象属性来格式化纯文本内容。您添加到默认值的内容会出现在生成的报告内容之前。

示例: 'TextFormatter.Color','red'

方法

全部展开

示例

全部折叠

从文本文件创建一份段落报告。

首先，创建一个文本文件并将其保存为 my_script.txt 以供本示例使用。接下来，导入报告 API 命名空间，这样您就不必使用长的完全限定类名。

import mlreportgen.report.*

创建 PFD 报 告。

rpt = Report("MyReport","pdf");
open(rpt);

创建一个空白章节。

chap = Chapter("TextFile Reporter");

创建一个 TextFile 报告器。指定段落分隔符，以便报告在每个换行符处创建一个新段落。

rptr = TextFile("my_script.txt");
rpt.ParaSep = [newline newline];

将报告器追加到章节，并将章节追加到报告中。

append(chap,rptr);
append(rpt,chap);

关闭并查看报告。

close(rpt);
rptview(rpt);

版本历史记录

在 R2023a 中推出