---
title: 单元素模式数据读取
description: "- 以单元素方式读取数据。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0060.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/userg_hyperio_0060.html
indexId: e5125bb956e53b867764b1b085c08946e0304cff1b211bbb3a264838a55446ce58
---
# 单元素模式数据读取

#### 函数定义

- 以单元素方式读取数据。
  nc_get_var1(int ncid, int varid, const size_t* indexp, void* ip)

- 以单元素方式读取int类型数据。
  nc_get_var1_int(int ncid, int varid, const size_t* indexp, int* ip)

- 以单元素方式读取double类型数据。
  nc_get_var1_double(int ncid, int varid, const size_t* indexp, double* ip)


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| ncid | 文件ID | 非负整数 | 输入 |
| varid | variable ID | 非负整数 | 输入 |
| \*indexp | 访问数据的起始向量 | 非空 | 输入 |
| \*ip | 数据指针 | 非空 | 输出 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| NC\_EBADID | 无效ncid |
| NC\_ENOTVAR | 无法找到variable |
| NC\_EINVALCOORDS | 无效坐标参数 |
| NC\_EEDGE | 超出维度界限 |


#### 注意

用户需要保证指针内存大小正确性，中间件无法检查指针大小。