异常处理程序
函数定义
- 注册用户例程函数以用作MPI异常处理程序。
MPI_File_create_errhandler(MPI_File_errhandler_function *function, MPI_Errhandler *errhandler)
PMPI_File_create_errhandler(MPI_File_errhandler_function *function, MPI_Errhandler *errhandler)
- 提供错误码并调用异常处理程序。
MPI_File_call_errhandler(MPI_File fh, int errorcode)
PMPI_File_call_errhandler(MPI_File fh, int errorcode)
- 设置文件的异常处理程序。
MPI_File_set_errhandler(MPI_File fh, MPI_Errhandler errhandler)
PMPI_File_set_errhandler(MPI_File fh, MPI_Errhandler errhandler)
- 获取文件的异常处理程序。
MPI_File_get_errhandler(MPI_File fh, MPI_Errhandler *errhandler)
PMPI_File_get_errhandler(MPI_File fh, MPI_Errhandler *errhandler)
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
*function |
用户定义异常处理程序 |
非空 |
输入 |
*errhandler |
目标地址，存放MPI错误处理（句柄） |
非空 |
输出 |
fh |
绑定错误处理句柄的文件（句柄） |
非空 |
输入 |
errorcode |
MPI错误码 |
非空 |
输入 |
errhandler |
MPI错误处理（句柄） |
非空 |
输入 |
返回值
- 成功：返回MPI_SUCCESS。
- 失败：返回错误码。
错误码
错误码 |
描述 |
|---|---|
MPI_ERR_FILE |
无效文件句柄 |
MPI_ERR_ARG |
其他类型的无效参数 |
MPI_ERR_OTHER |
其他错误 |
注意
用户定义的异常处理程序正确性由用户进行保证。