mdfInfo

访问或创建 MDF 文件元数据

自 R2019b 起

语法

fileInfo = mdfInfo(mdfFileName)

fileInfo = mdfInfo

说明

fileInfo = mdfInfo(mdfFileName) 返回 MDFInfo 对象，该对象包含有关指定的 MDF 文件的信息，包括名称、位置、版本、大小、数据的初始时间戳等。mdfFileName 指定 MDF 文件的绝对、相对或 URL 路径。

示例

fileInfo = mdfInfo 创建默认 MDFInfo 对象，您可以自定义该对象并与 mdfCreate 结合使用，以便在文件创建过程中配置 MDF 文件元数据。

示例

全部折叠

访问关于 MDF 文件的信息

获取 MDF 文件信息，并以编程方式读取其版本。

fileInfo = mdfInfo("MDFFile.mf4");

fileInfo = 

  MDFInfo with properties:

   File Details
                  Name: "VehicleData.mf4"
                  Path: "E:\data\VehicleData.mf4"
                Author: ""
            Department: ""
               Project: ""
               Subject: ""
               Comment: "Example file with demo data."
               Version: "4.10"
      InitialTimestamp: 2022-01-20 01:22:34.000000000

   Creator Details
     ProgramIdentifier: "MATLAB"
     CreatorVendorName: "The MathWorks, Inc."
       CreatorToolName: "MATLAB"
    CreatorToolVersion: "9.12.0.1846952 (R2022a)"
       CreatorUserName: ""
        CreatorComment: ""

   File Contents
            Attachment: [1×8 table]
     ChannelGroupCount: 2

读取 Version 属性。

fileInfo.Version

ans =

    "4.10"

为新文件创建 MDFInfo 对象

创建和修改 MDFInfo 对象，以便使用自定义元数据配置新 MDF 文件。

minfo = mdfInfo;
minfo.Comment = "25-Dec Shift B.";
%   ⋮
% Modify other properites as needed
%   ⋮
mdfCreate("MyMDFfile.mf4",FileInfo=minfo)

输入参数

全部折叠

`mdfFileName` — MDF 文件名
字符串 | 字符向量

MDF 文件名（包括必要的完整或相对路径），指定为字符串或字符向量。您可以使用 URL 来指定远程服务器上的文件。

根据您要访问的位置，mdfFileName 可以采用以下形式之一。

位置

形式

当前文件夹或 MATLAB^® 路径

要访问当前文件夹或 MATLAB 路径中的文件，请在 filename 中指定文件名（包括文件扩展名）。

示例："myMdfFile.mf4"

其他文件夹

要访问当前文件夹以外的文件夹中的文件，请在 filename 中指定完整或相对路径名称。

示例："C:\myFolder\myMdfFile.mf4"

示例："\dataDir\myMdfFile.mf4"

远程位置

要访问远程位置的文件，filename 必须包含指定为统一资源定位器 (URL) 形式的文件的完整路径：

scheme://path_to_file/myMdfFile.mf4

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

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

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

示例："s3://bucketname/path_to_file/myMdfFile.mf4"

数据类型: char | string

输出参量

全部折叠

`fileInfo` — MDF 文件元数据信息
`MDFInfo` 对象

MDF 文件元数据信息，以具有以下属性的 MDFInfo 对象形式返回：

MDFInfo 对象属性

属性名称	数据类型	访问
文件详细信息
`Name`	字符串	只读
`Path`	字符串	只读
`Author`	字符串	读/写
`Department`	字符串	读/写
`Project`	字符串	读/写
`Subject`	字符串	读/写
`Comment`	字符串	读/写
`Version`	字符串	读/写
`InitialTimestamp`	日期时间	读/写
创建者详细信息
`ProgramIdentifier`	字符串	只读
`CreatorVendorName`	字符串	只读
`CreatorToolName`	字符串	只读
`CreatorToolVersion`	字符串	只读
`CreatorUserName`	字符串	读/写
`CreatorComment`	字符串	读/写
文件内容
`Attachment`	表	只读
`ChannelGroupCount`	uint64	只读