---
title: 查询文件和维度信息
description: "- 查询信息。"
url: https://www.hikunpeng.com/document/detail/zh/hpchistory/hpckit/develop2400/userg_hyperio_0069.html
sourcePath: /source/zh/hpchistory/hpckit/develop2400/userg_hyperio_0069.html
indexId: 7e19ac3828ef409493edb5a3b26a419192f864bce8753078e13fe1a7bb01d12464
---
# 查询文件和维度信息

#### 函数定义

- 查询信息。
  int ncmpi_inq(int fileId, int* nDims, int* nVars, int* nGAtts, int* unlimDimId);

  int ncmpi_inq_version(int fileId, int* ncMode);

  const char* ncmpi_inq_libvers(void)

- 查询维度信息。
  int ncmpi_inq_dim(int fileId, int dimId, char* name, MPI_Offset* length);

  int ncmpi_inq_dimlen(int fileId, int dimId, MPI_Offset* lenPoint);

  int ncmpi_inq_dimid(int fileId, const char* name, int* idPoint);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| fileId | 文件ID | 非负整数 | 输入 |
| \*nDims | 返回dim数量的指针 | 非空 | 输出 |
| \*nVars | 返回variable数量的指针 | 非空 | 输出 |
| \*nGAtts | 返回att数量的指针 | 非空 | 输出 |
| \*unlimDimId | 返回unlimited dim的ID | 非空 | 输出 |
| \*ncMode | 返回format version的指针 | 非空 | 输出 |
| dimId | 维度的ID | 非负整数 | 输入 |
| \*name | 返回维度名称的指针 | 非空 | 输出/输入 |
| \*length | 返回维度长度的指针 | 非空 | 输出 |
| \*lenPoint | 返回维度长度的指针 | 非空 | 输出 |
| \*idPoint | 返回维度ID的指针 | 非空 | 输出 |


#### 返回值

- 成功：返回NC_NOERR。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| NC\_EBADID | 无效ncid |
| NC\_ENBADDIM | 无效dimid |
| NC\_ENOMEM | 空指针或无效内存 |


#### 注意

*nDims、*nVars、*nGAtts、*unlimDimId、*ncMode、*name、*length、*lenPoint、*idPoint参数在不需要获取数据时可以为空指针，需要获取数据时必须非空。