---
title: 查询维度信息
description: "- 查询维度名称和长度。"
url: https://www.hikunpeng.com/document/detail/zh/hpchistory/hpckit/develop2400/userg_hyperio_0054.html
sourcePath: /source/zh/hpchistory/hpckit/develop2400/userg_hyperio_0054.html
indexId: d06065a5f3b608820f0935ca93db55afbfd857b8c2b5d530540a494d5dbea5cb64
---
# 查询维度信息

#### 函数定义

- 查询维度名称和长度。
  nc_inq_dim(int ncid, int dimid, char *name, size_t* lenp)

- 查询维度名称。
  nc_inq_dimname(int ncid, int dimid, char *name)

- 查询维度长度。
  nc_inq_dimlen(int ncid, int dimid, size_t *lenp)

- 根据名称查询维度ID。
  nc_inq_dimid(int ncid, const char *name, int* idp)


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| ncid | 文件ID | 非负整数 | 输入 |
| dimid | 维度ID | 非负整数 | 输入 |
| const \*name | 维度名称 | 非空，长度小于256字节 | 输入 |
| \*name | 返回维度名称的指针 | 非空 | 输出 |
| \*lenp | 返回维度长度的指针 | 非空 | 输出 |
| \*idp | 返回维度ID的指针 | 非空 | 输出 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| NC\_EBADID | 无效ncid |
| NC\_ENBADDIM | 无效dimid |


#### 注意

*name、*lenp、*idp参数在不需要获取数据时可以为空指针，需要获取数据时必须非空。