Main Content

netcdf.renameVar

更改 netCDF 变量名

语法

netcdf.renameVar(ncid,varid,newName)

说明

netcdf.renameVar(ncid,varid,newName) 重命名 ncid 标识的 netCDF 文件中 varid 所标识的变量。newName 是一个指定新名称的字符向量或字符串标量。

此函数对应于 netCDF 库 C API 中的 nc_rename_var 函数。要使用此函数,应该熟悉 netCDF 编程范式。

示例

本例修改 MATLAB® 随附的 netCDF 示例文件 example.nc 的本地副本。

% Open netCDF file.
ncid = netcdf.open('my_example.nc','NC_WRITE')

% Put file in define mode.
netcdf.redef(ncid)

% Get name of first variable
[varname, xtype, varDimIDs, varAtts] = netcdf.inqVar(ncid,0);

varname

varname =

avagadros_number

% Rename the variable, using a capital letter to start the name.
netcdf.renameVar(ncid,0,'Avagadros_number')

% Verify that the name of the variable changed.
[varname, xtype, varDimIDs, varAtts] = netcdf.inqVar(ncid,0);

varname

varname =

Avagadros_number