查询公共信息
函数定义
- 查询有关文件的信息。
nc_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp)
- 查询文件格式的信息。
- 查询文件详细格式的信息。
- 查询variable数量。
- 查询维度数量。
nc_inq_unlimdims(int ncid, int *nunlimdimsp, int *unlimdimidsp)
- 查询类型id。
- 查询group数量。
- 查询groups名称。
- 查询group所有ncid。
nc_inq_grp_full_ncid(int ncid, const char* full_name, int *grp_ncid)
- 查询维度ID和数量。
nc_inq_dimids(int ncid, int *ndims, int *dimids, int include_parents)
- 查询属性类型。
nc_inq_atttype(int ncid, int varid, const char *name, nc_type *xtypep)
- 查询变量类型。
- 查询变量名称。
- 查询全局属性。
- 查询变量属性。
- 查询变量信息。
nc_inq_var_deflate(int ncid, int varid, int *shufflep, int *deflatep, int *deflate_levelp)
- 查找与变量关联并具有指定ID的过滤器的参数信息。
nc_inq_var_filter_info(int ncid, int varid, unsigned int id, size_t *nparamsp, unsigned int *params)
- 查找与变量关联的过滤器集。
nc_inq_var_filter_ids(int ncid, int varid, size_t * nfiltersp, unsigned int * ids)
nc_inq_var_filterids(int ncid, int varid, size_t *nfilters, unsigned int *filterids)
- 获取变量的存储和分块大小。
nc_inq_var_chunking(int ncid, int varid, int *storagep, size_t *chunksizesp)
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
---|---|---|---|
ncid |
文件ID |
非负整数 |
输入 |
varid |
变量ID |
非负整数 |
输入 |
id |
过滤器ID |
非负整数 |
输入 |
*ndimsp |
返回dim数量的指针 |
非空 |
输出 |
*nvarsp |
返回variable数量的指针 |
非空 |
输出 |
*nattsp |
返回attribute数量的指针 |
非空 |
输出 |
*unlimdimidp |
返回第一个无限维度id的指针 |
非空 |
输出 |
*formatp |
返回文件格式的指针 |
非空 |
输出 |
*modep |
返回文件模式的指针 |
非空 |
输出 |
*nunlimdimsp |
返回无限维度数量的指针 |
非空 |
输出 |
*ntypes |
返回类型数量的指针 |
非空 |
输出 |
*typeids |
返回第一个类型id的指针 |
非空 |
输出 |
*numgrps |
返回group数量的指针 |
非空 |
输出 |
*nfilters |
返回过滤器数量的指针 |
非空 |
输出 |
*filterids |
返回过滤器ID的指针 |
非空 |
输出 |
*storagep |
返回存储大小的指针 |
非空 |
输出 |
*chunksizesp |
返回分块大小的指针 |
非空 |
输出 |
返回值
- 成功:返回NC_NOERR。
- 失败:返回错误码。
错误码
错误码 |
描述 |
---|---|
NC_EBADID |
无效ncid |
注意
- nc_inq_format的默认文件格式为NC_FORMAT_CLASSIC,支持nc_create_par中cmode为NC_64BIT_OFFSET、NC_64BIT_DATA、NC_NETCDF4情况下的格式查询。
- nc_inq_format_extended的默认文件扩展格式为NC_FORMATX_PNETCDF,支持nc_create_par中cmode为NC_64BIT_OFFSET、NC_64BIT_DATA、NC_NETCDF4情况下的格式查询。
- *ndimsp、*nvarsp、*nattsp、*unlimdimidp、*formatp、*modep、*nunlimdimsp、*ntypes、*typeids、*numgrps、*nfilters、*filterids、*storagep、*chunksizesp参数在不需要获取数据时可以为空指针,需要获取数据时必须非空。