定义新变量相关函数
函数定义
- 定义一个新变量。
nc_def_var(int ncid, const char *name, nc_type xtype, int ndims, const int *dimidsp, int *varidp)
- 设置新的过滤器。
nc_def_var_filter(int ncid, int varid, unsigned int id, size_t nparams, const unsigned int *params)
- 设置netCDF/HDF5文件中变量的zlib压缩和随机设置。
nc_def_var_deflate(int ncid, int varid, int shuffle, int deflate, int deflate_level)
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
---|---|---|---|
ncid |
文件ID |
非负整数 |
输入 |
*name |
变量名称 |
非空,长度小于256字节 |
输入 |
xtype |
变量数据类型 |
非负整数 |
输入 |
ndims |
维度数量 |
[1,1024] |
输入 |
*dimidsp |
维度ID列表 |
非空 |
输入 |
*varidp |
变量ID的指针 |
非空 |
输入 |
id |
过滤器ID |
整数 |
输入 |
nparams |
参数个数 |
非空 |
输入 |
*params |
指向设置的参数的指针 |
非空 |
输入 |
varid |
变量ID |
非负整数 |
输入 |
shuffle |
随机设置参数 |
非空 |
输入 |
deflate |
压缩设置参数 |
非空 |
输入 |
deflate_level |
压缩等级 |
非空 |
输入 |
返回值
- 成功:返回NC_NOERR。
- 失败:返回错误码。
错误码
错误码 |
描述 |
---|---|
NC_EBADID |
无效ncid |
NC_EBADTYPE |
无效数据类型 |
NC_EINVAL |
无效参数 |
注意
- 目前仅支持有限数据类型:NC_BYTE、NC_UBYTE、NC_CHAR、NC_SHORT、NC_USHORT、NC_INT、NC_UINT、NC_INT64、NC_UINT64、NC_FLOAT、NC_DOUBLE。
- 维度ID列表内存大小需要与维度数量对应,不进行检查。
父主题: 信息设置