查询文件和维度信息
函数定义
- 查询信息。
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参数在不需要获取数据时可以为空指针，需要获取数据时必须非空。