---
title: 查询公共信息
description: "- 查询有关文件的信息。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0053.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0053.html
indexId: aeaec05fbcdaab51837d5aab4798b2e87ac5ac931dc8a08f15dde5c75e6f653258
---
# 查询公共信息

#### 函数定义

- 查询有关文件的信息。
  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 varid, 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参数在不需要获取数据时可以为空指针，需要获取数据时必须非空。