mlreportgen.utils.fileToURI

将文件路径转换为统一资源标识符

全页折叠

语法

uri = mlreportgen.utils.fileToURI(filename)

说明

uri = mlreportgen.utils.fileToURI(filename) 将 filename 转换为统一资源标识符 (URI)。

URI 是指定文件名和文件路径的字符串。URI 允许通过网络访问资源。Web 地址 (URL) 是 URI 的一种类型。有关 URI 的详细信息，请参阅万维网联盟网站上的 URI 规范。

示例

全部折叠

将文件名转换为 URI

uri = mlreportgen.utils.fileToURI...
   ("C:/Users/jsmith/Desktop/200-C Form.pdf")

uri = 

    "file:///C:/Users/jsmith/Desktop/200-C%20Form.pdf"

输入参数

全部折叠

`filename` — 要转换的文件的名称或完整路径
字符向量 | 字符串标量

要转换的文件的名称或完整路径，指定为字符向量或字符串标量。有关未编码、保留和已编码 ASCII 字符的完整列表，请参阅详细信息。

输出参量

全部折叠

`uri` — 统一资源标识符
字符向量 | 字符串标量

文件的 URI，以字符向量或字符串标量形式返回。

详细信息

全部折叠

保留字符

保留字符对文件和 Web 服务器具有特殊含义，将其包含在文件路径中可能会导致错误。保留字符为：:, /。如果文件名包含保留字符，mlreportgen.utils.fileToURI 不会对其进行百分号编码。

例如，如果文件名为：

C:/Users/jsmith/Desktop/Report@Store1

编码后的 URI 为：

C:/Users/jsmith/Desktop/Report@Store1

如果路径中包含这些字符之一导致了错误或警告，请删除或替换路径中的该字符。

未编码的 ASCII 字符

mlreportgen.utils.fileToURI 不编码以下字母数字或未保留字符：

字母数字字符：A–Z、a–z、0–9
非保留字符：-、_、.、~

例如，如果文件名为：

C:/Users/jsmith/Desktop/My_Report

编码后的 URI 为：

C:/Users/jsmith/Desktop/My_Report

不安全字符

不安全字符在 URI 标准中具有保留含义，或者在未正确编码时会破坏解析，例如被错误地解释为分隔符。为确保互操作性并降低注入漏洞风险，URI 标准规定对不安全字符进行百分号编码。mlreportgen.utils.fileToURI 会对这些字符应用百分号编码。

空格、!、"、#、$、%、&、'、(、)、+、,、;、<、=、>、?、@、[、\、]、^、`、{、}，控制字符:ASCII 0–31、127

例如，如果文件名为：

C:/Users/jsmith/Desktop/My Report #1.docx

编码后的 URI 为：

C:/Users/jsmith/Desktop/My%20Report%20%231.docx"

有关 ASCII 字符值的列表，请参阅https://en.wikipedia.org/wiki/ASCII#Table_of_codes。

非 ASCII 字符

mlreportgen.utils.fileToURI 通过先应用 UTF-8 编码再进行百分号编码来编码所有非 ASCII 字符。

例如，如果文件名为：

C:/Users/jsmith/Desktop/Élodie Dufrêne Bio.pdf

编码后的 URI 为：

C:/Users/jsmith/Desktop/%C3%89lodie%20Dufr%C3%AAne%20Bio.pdf

版本历史记录

在 R2018b 中推出

另请参阅

mlreportgen.utils.findFile

mlreportgen.utils.fileToURI

语法

说明

示例

将文件名转换为 URI

输入参数

filename — 要转换的文件的名称或完整路径 字符向量 | 字符串标量

输出参量

uri — 统一资源标识符 字符向量 | 字符串标量

详细信息

保留字符

未编码的 ASCII 字符

不安全字符

非 ASCII 字符

版本历史记录

另请参阅

`filename` — 要转换的文件的名称或完整路径
字符向量 | 字符串标量

`uri` — 统一资源标识符
字符向量 | 字符串标量