Main Content

netcdf.abort

还原最近的 netCDF 文件定义

语法

netcdf.abort(ncid)

说明

netcdf.abort(ncid) 将 netCDF 文件还原到以前状态,放弃文件上一次进入定义模式以来的所有定义。当您创建文件(使用 netcdf.create)或明确进入定义模式(使用 netcdf.redef)时,文件即进入定义模式。一旦离开定义模式(使用 netcdf.endDef),将无法恢复您在定义模式下所做的定义。ncidnetcdf.createnetcdf.open 返回的 netCDF 文件标识符。调用 netcdf.abort 关闭文件。

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

示例

本例创建一个新文件,对文件执行操作,然后再将文件恢复到原始状态。要运行本例,必须对当前目录拥有写入权限。

% Create a netCDF file
ncid = netcdf.create('foo.nc','NC_NOCLOBBER');

% Perform an operation, such as defining a dimension.
dimid = netcdf.defDim(ncid, 'lat', 50);

% Revert the file back to its previous state.
netcdf.abort(ncid)

% Verify that the file is now closed.
dimid = netcdf.defDim(ncid, 'lat', 50); % should fail
??? Error using ==> netcdflib
NetCDF: Not a valid ID

Error in ==> defDim at 22
dimid = netcdflib('def_dim', ncid,dimname,dimlen);