Main Content

cdflib.createVar

创建新变量

语法

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance)

说明

varnum = cdflib.createVar(cdfId, varname, datatype, numElements, dims, recVariance, dimVariance) 在常用数据格式 (CDF) 文件中创建具有指定特征的一个新变量。

输入参数

cdfId

CDF 文件的标识符，通过调用 cdflib.create 或 cdflib.open 返回。

varname

指定要赋给变量的名称的字符向量或字符串标量。

datatype

变量的数据类型，指定为以下包含有效 CDF 数据类型的字符向量或字符串标量之一或其等效数值。

CDF 数据类型描述
'CDF_BYTE1 字节的有符号整数
'CDF_CHAR'

1 字节的有符号字符数据类型，将映射到 MATLAB® char 或 string 类。

'CDF_INT1'1 字节的有符号整数
'CDF_UCHAR'

1 字节的无符号字符数据类型，将映射到 MATLAB uint8 类

'CDF_UINT1'1 字节的无符号整数
'CDF_INT2'2 字节的有符号整数
'CDF_UINT2'2 字节的无符号整数
'CDF_INT4'4 字节的有符号整数
'CDF_UINT4'4 字节的无符号整数
'CDF_FLOAT'4 字节的浮点数
'CDF_REAL4'4 字节的浮点数
'CDF_REAL8'8 字节的浮点数。
'CDF_DOUBLE'8 字节的浮点数
'CDF_EPOCH'8 字节的浮点数
'CDF_EPOCH16'两个 8 字节的浮点数

numElements

每个数据的元素数目。除 'CDF_CHAR' 和 'CDF_UCHAR' 之外，所有数据类型的值都应为 1。

dims

一个由维度范围组成的向量；如果不存在维度范围，则为空。

recVariance

指定记录方差：true 或 false。

dimVariance

一个由逻辑值组成的向量；如果不存在任何维度，则为空。

输出参量

varNum

变量的数值标识符。变量编号从 0 开始。

示例

创建一个 CDF 文件，然后在该 CDF 文件中创建一个名为 'Time' 的变量。该变量不包含任何维度，并且在各个记录中不同。要运行此示例，当前必须位于可写文件夹中。

cdfId = cdflib.create("your_file.cdf");

% Initially the file contains no variables
info = cdflib.inquire(cdfId)
info = 

  struct with fields:

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 0
    numvAttrs: 0
    numgAttrs: 0
% Create a variable in the file
varNum = cdflib.createVar(cdfId,"Time","cdf_int1",1,[],true,[]);

% Retrieve info about the file again to verify variable was created
% Note value of numVars field is now 1
info = cdflib.inquire(cdfId)
info = 

  struct with fields:

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 1
    numvAttrs: 0
    numgAttrs: 0
% Clean up
cdflib.delete(cdfId)
clear cdfId

参考

此函数对应于 CDF 库的 C API 例程 CDFcreatezVar。

要使用此函数，必须熟悉 CDF C 接口。您可以在 CDF 网站上访问 CDF 文档。

另请参阅

|

主题