查询变量和属性信息
函数定义
- 查询变量信息。
int ncmpi_inq_varid(int fileId, const char* name, int* idPoint);
int ncmpi_inq_var(int fileId, int variableId, char* name, int* ncDataType, int* dimNumber, int* dimsArray, int* nattsp);
int ncmpi_inq_varndims(int fileId, int variableId, int* dimNumber);
- 查询属性信息。
int ncmpi_inq_att(int fileId, int varId, const char* name, int* xtypep, MPI_Offset* lenp);
int ncmpi_inq_attname(int fileId, int varId, int attNum, char* name);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
fileId |
文件ID |
非负整数 |
输入 |
*idPoint |
返回variable ID的指针 |
非空 |
输出 |
variableId/varId |
variable ID |
非负整数 |
输入 |
const *name |
variable名称/attribute名称 |
非空，长度小于256字节 |
输入 |
*name |
variable名称/attribute名称 |
非空 |
输出 |
*ncDataType |
返回variable数据类型的指针 |
非空 |
输出 |
*dimNumber |
返回维度数量的指针 |
非空 |
输出 |
*dimsArray |
返回维度ID数组的指针 |
非空 |
输出 |
*nattsp |
返回属性数量的指针 |
非空 |
输出 |
*xtypep |
返回att类型的指针 |
非空 |
输出 |
*lenp |
返回att数量的指针 |
非空 |
输出 |
attNum |
att ID |
非负整数 |
输入 |
返回值
- 成功：返回NC_NOERR。
- 失败：返回错误码。
错误码
错误码 |
描述 |
|---|---|
NC_EBADID |
无效ncid |
NC_ENBADDIM |
无效dimid |
NC_ENOMEM |
空指针或无效内存 |
NC_EBADNAME |
无效名称 |
注意
*idPoint、*name、*ncDataType、*dimNumber、*dimsArray、*nattsp、*xtypep、*lenp参数在不需要获取数据时可以为空指针，在需要获取数据时必须非空。
