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

#### 函数定义

- 查询维度名称和长度。
  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\_EBADDIM | 无效dimid |


#### 注意

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