主要内容

nextfile

R2026b

类: matlab.io.datastore.DsFileSet
命名空间: matlab.io.datastore

下一个文件或文件块的信息

语法

fileInfo = nextfile(fs)

描述

fileInfo = nextfile(fs) 返回文件集对象 fs 中存在的下一个文件的信息。对 nextfile 函数的后续调用继续从上一调用的端点读取。

输入参数

全部展开

输入文件集对象,指定为 DsFileSet 或 FileSet 对象。要创建 DsFileSet 对象,请参阅 matlab.io.datastore.DsFileSet。要创建 FileSet 对象,请参阅 matlab.io.datastore.FileSet。

输出参量

全部展开

文件信息,以表的形式返回。该表包含 DSFileSet 的 FileName、FileSize、Offset 和 SplitSize 列。文件信息以 FileSet 对象的 FileInfo 对象形式返回,包含 Filename 和 FileSize 字段。

示例

一次获取一个文件的信息

创建一个文件集对象,然后以迭代方式一次获取一个文件的信息。

为 demos 文件夹中的所有 .mat 文件创建一个文件集对象。

folder = "C:/folder1";
fs = matlab.io.datastore.DsFileSet(folder,...
                 'IncludeSubfolders',true,...
                 'FileExtensions','.mat');

获取文件集对象 fs 中的文件信息,一次一个文件。

while hasfile(fs)
   file = nextfile(fs);
end

提示

  • 如果文件集对象 fs 中不存在更多文件,nextfile 方法将返回错误。为了避免此错误,可将 nextfile 与 hasfile 和 reset 结合使用。hasfile 方法检查文件集对象中是否还有文件,而 reset 方法可将内部文件指针重置到文件集对象的开头。

版本历史记录

在 R2017b 中推出