Main Content

cdflib.putAttrgEntry

将值写入具有全局作用域的属性中的条目

语法

cdflib.putAttrgEntry(cdfId,attrNum,entryNum,cdfDataType,entryVal)

说明

cdflib.putAttrgEntry(cdfId,attrNum,entryNum,cdfDataType,entryVal) 将值写入常用数据格式 (CDF) 文件中的全局属性条目。

输入参数

cdfId

CDF 文件的标识符,通过调用 cdflib.createcdflib.open 返回。

attrNum

数值,用于标识属性。属性编号从 0 开始。该属性必须具有全局作用域。

entryNum

数值,用于标识条目。条目编号从 0 开始。

CDFdatatype

属性条目的数据类型,指定为以下字符向量或字符串标量之一或其等效数值。

CDF 数据类型MATLAB® 的等同类型
'CDF_BYTE'1 字节的有符号整数
'CDF_CHAR'

1 字节的有符号字符数据类型,将映射到 MATLAB charstring 类。

'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 字节的浮点数

entryVal

要写入全局属性条目的数据。

示例

创建一个 CDF 文件,然后在该文件中创建一个全局属性。将值写入属性中的条目。要运行此示例,当前必须位于可写文件夹中。

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

% Initially, the file contains no global or variable attributes
info = cdflib.inquire(cdfId)
info = 

  struct with fields:

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 0
    numvAttrs: 0
    numgAttrs: 0
% Create a global attribute in the file.
attrNum = cdflib.createAttr(cdfId,"Purpose","global_scope");

% Write a value to an entry for the global attribute
cdflib.putAttrgEntry(cdfId,attrNum,0,"CDF_CHAR","My Test")

% Get the value of the global attribute entry
value = cdflib.getAttrgEntry(cdfId,attrNum,0)
value =

    'My Test'
% Clean up
cdflib.delete(cdfId)
clear cdfId

参考

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

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