17.2.168. MPI_Get_address
MPI_Get_address — 获取内存中某个位置的地址。
17.2.168.1. 语法
17.2.168.1.1. C语言语法
#include <mpi.h>
int MPI_Get_address(const void *location, MPI_Aint *address)
17.2.168.1.2. Fortran 语法
USE MPI
! or the older form: INCLUDE 'mpif.h'
MPI_GET_ADDRESS(LOCATION, ADDRESS, IERROR)
<type> LOCATION(*)
INTEGER(KIND=MPI_ADDRESS_KIND) ADDRESS
INTEGER IERROR
17.2.168.1.3. Fortran 2008 语法
USE mpi_f08
MPI_Get_address(location, address, ierror)
TYPE(*), DIMENSION(..), ASYNCHRONOUS :: location
INTEGER(KIND=MPI_ADDRESS_KIND), INTENT(OUT) :: address
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
17.2.168.2. 输入参数
location: 调用者内存中的位置（选项）。
17.2.168.3. 输出参数
address: 位置地址（整数）。ierror: 仅限Fortran：错误状态（整数）。
17.2.168.4. 描述
MPI_Get_address 返回内存中某个位置的字节 address。
示例：对数组使用MPI_Get_address。
REAL :: A(100,100)
INTEGER(MPI_ADDRESS_KIND) :: I1, I2, DIFF
CALL MPI_GET_ADDRESS(A(1,1), I1, IERROR)
CALL MPI_GET_ADDRESS(A(10,10), I2, IERROR)
DIFF = I2 - I1
! The value of DIFF is 909*sizeofreal; the values of I1 and I2 are
! implementation dependent.
17.2.168.5. 注意事项
该例程同时为Fortran和C程序员提供，在编写可移植代码时可能很有用。在当前版本中，此例程返回的地址将与C语言&运算符生成的地址相同。
C语言用户可能会倾向于避免使用MPI_Get_address而依赖地址运算符&的可用性。但需要注意的是，&强制转换表达式是一个指针，而非地址。虽然通常情况下确实如此，但ANSI C并不要求指针的值（或强制转换为int的指针）必须是被指向对象的绝对地址。此外，在具有分段地址空间的机器上，引用可能没有唯一的定义。使用MPI_Get_address来"引用"C变量可以确保在这些机器上的可移植性。
现有的Fortran MPI代码无需修改即可运行，并能移植到任何系统。然而，如果程序中使用了超过2^32 - 1的地址，可能会失败。新代码应使用新函数编写，这能确保与C语言的兼容性，并避免在64位架构上出错。但需要注意的是，这类新编写的代码可能需要（轻微）修改才能移植到不支持KIND声明的旧Fortran 77环境中。
17.2.168.6. 错误
几乎所有MPI例程都会返回一个错误值；C语言例程通过函数返回值返回，Fortran例程则通过最后一个参数返回。
在返回错误值之前，会调用与通信对象（如通信器、窗口、文件）关联的当前MPI错误处理程序。如果MPI调用未关联任何通信对象，则该调用被视为附加到MPI_COMM_SELF，并将调用关联的MPI错误处理程序。当MPI_COMM_SELF未初始化时（即在MPI_Init/MPI_Init_thread之前、MPI_Finalize之后，或仅使用会话模型时），错误会触发初始错误处理程序。初始错误处理程序可通过在使用世界模型时调用MPI_Comm_set_errhandler来修改MPI_COMM_SELF，或通过mpiexec的mpi_initial_errhandler命令行参数，或MPI_Comm_spawn/MPI_Comm_spawn_multiple的info键来设置。如果未设置其他适当的错误处理程序，则MPI I/O函数将调用MPI_ERRORS_RETURN错误处理程序，而其他所有MPI函数将调用MPI_ERRORS_ABORT错误处理程序。
Open MPI 包含三个可使用的预定义错误处理器：
MPI_ERRORS_ARE_FATAL导致程序中止所有连接的MPI进程。MPI_ERRORS_ABORT一个可在通信器、窗口、文件或会话上调用的错误处理程序。当在通信器上调用时，其行为类似于在该通信器上调用MPI_Abort。如果在窗口或文件上调用，则行为类似于在包含对应窗口或文件中进程组的通信器上调用MPI_Abort。如果在会话上调用，则仅中止本地进程。MPI_ERRORS_RETURN向应用程序返回一个错误代码。
MPI应用程序也可以通过调用以下方式实现自己的错误处理程序：
请注意，MPI不保证MPI程序在出现错误后能够继续运行。
有关更多信息，请参阅MPI-3.1标准中的错误处理部分。