中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助
鲲鹏小智

查询公共信息

函数定义

  • 查询有关文件的信息。

    nc_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp)

  • 查询文件格式的信息。

    nc_inq_format(int ncid, int *formatp)

  • 查询文件详细格式的信息。

    nc_inq_format_extended(int ncid, int *formatp, int *modep)

  • 查询variable数量。

    nc_inq_nvars(int ncid, int *nvarsp)

  • 查询维度数量。

    nc_inq_unlimdims(int ncid, int *nunlimdimsp, int *unlimdimidsp)

  • 查询类型id。

    nc_inq_typeids(int ncid, int *ntypes, int *typeids)

  • 查询group数量。

    nc_inq_grps(int ncid, int *numgrps, int *ncids)

  • 查询groups名称。

    nc_inq_grpname(int ncid, char *name)

  • 查询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_vartype(int ncid, int varid, nc_type *typep)

  • 查询变量名称。

    nc_inq_varname(int ncid, int vaird, char *name)

  • 查询全局属性。

    nc_inq_natts(int ncid, int *nattsp)

  • 查询变量属性。

    nc_inq_varnatts(int ncid, int varid, int *nattsp)

  • 查询变量信息。

    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参数在不需要获取数据时可以为空指针,需要获取数据时必须非空。