Main Content

cdfinfo

有关常用数据格式 (CDF) 文件的信息

语法

info = cdfinfo(filename)

说明

info = cdfinfo(filename) 返回 filename 指定的常用数据格式 (CDF) 文件的有关信息。以字符向量或字符串标量形式指定 filename

注意

因为 cdfinfo 将创建临时文件,所以当前工作目录是必须可写的。

下表列出了结构体 info 中返回的字段。表中所列字段的顺序与字段在结构体中的显示顺序相同。

字段

描述

Filename

指定文件名的字符向量

FileModDate

指示上次修改文件的日期的字符向量

FileSize

指定文件大小(以字节为单位)的双精度标量

Format

指定文件格式的字符向量

FormatVersion

指定用于创建文件的 CDF 库版本的字符向量

FileSettings

包含用于创建文件的库设置的结构体数组

Subfiles

包含 CDF 文件的数据的文件名(如果该文件为多文件格式 CDF)

Variables

N×6 元胞数组,其中 N 是变量的数目,包含有关文件中的变量的信息。各列提供以下信息:

第 1 列

指定变量名称的字符向量

第 2 列

指定变量的维度的双精度数组,由 size 函数返回

第 3 列

指定为变量分配的记录数的双精度标量

第 4 列

指定变量(如 CDF 文件中存储的变量)的数据类型的字符向量

第 5 列

指定变量的记录和维度方差设置的字符向量。斜杠左侧的单个 TF 指定值是否因记录而异。斜杠右侧的零或多个 TF 字母指定每个维度的值是否不同。下面给出了一些示例。

T/  (scalar variable 
F/T (one-dimensional variable)

T/TFF(三维变量)

GlobalAttributes

包含一个全局属性对应一个字段的结构体数组。每个字段的名称对应于一个属性的名称。包含在元胞数组中的每个字段内的数据表示该属性的项值。

VariableAttributes

包含一个变量属性对应一个字段的结构体数组。每个字段的名称对应于一个属性的名称。每个字段中的数据包含于 n×2 的元胞数组中,其中 n 是变量的数目。此元胞数组的第一列包含与各个项关联的变量名称。第二列包含项值。

注意

cdfinfo 返回的属性名称可能与 CDF 文件中的属性名称不完全匹配。属性名称可以包含在 MATLAB® 字段名称中属于非法的字符。cdfinfo 将删除显示在属性开头的非法字符并将其他非法字符替换为下换线 ('_')。当 cdfinfo 修改属性名称时,它会将属性的内部编号追加到字段名称的末尾。例如,属性名称 Variable%Attribute 将变为 Variable_Attribute_013

注意

要改善性能,请禁用打开文件时 CDF 库默认执行的文件验证。有关详细信息,请参阅 cdflib.setValidate

示例

全部折叠

获取有关示例文件 example.cdf 的信息。

info = cdfinfo('example.cdf')
info = struct with fields:
              Filename: 'example.cdf'
           FileModDate: '10-May-2010 21:35:01'
              FileSize: 1310
                Format: 'CDF'
         FormatVersion: '2.7.0'
          FileSettings: [1x1 struct]
              Subfiles: {}
             Variables: {6x6 cell}
      GlobalAttributes: [1x1 struct]
    VariableAttributes: [1x1 struct]

查看有关文件中变量的信息。

info.Variables
ans=6×6 cell array
    {'Time'            }    {[    1 1]}    {[24]}    {'epoch' }    {'T/'    }    {'Full'}
    {'Longitude'       }    {[    2 2]}    {[ 1]}    {'int8'  }    {'F/FT'  }    {'Full'}
    {'Latitude'        }    {[    2 2]}    {[ 1]}    {'int8'  }    {'F/TF'  }    {'Full'}
    {'Data'            }    {[  2 2 4]}    {[ 1]}    {'double'}    {'T/TTT' }    {'Full'}
    {'multidimensional'}    {[2 2 3 4]}    {[ 1]}    {'uint8' }    {'T/TTTT'}    {'Full'}
    {'Temperature'     }    {[    3 2]}    {[10]}    {'int16' }    {'T/TT'  }    {'Full'}

版本历史记录

在 R2006a 之前推出

全部展开