Synopsis

int MPI_Comm_toint(MPI_Comm comm)

Input Parameters

comm

communicator (handle)

Description

MPI_Comm_toint translates a C communicator handle into a C integer. For predefined handles, the integer value matches the values specified by the MPI ABI. For user-defined handles, the implementation returns the same integer for every call with the same handle, which does not conflict with the reserved range for predefined handles.

It is erroneous to call this function with an invalid comm argument.

Thread and Interrupt Safety

This routine is thread-safe. This means that this routine may be safely used by multiple threads without the need for any user-provided thread locks. However, the routine is not interrupt safe. Typically, this is due to the use of memory allocation routines such as 'malloc' or other non-MPICH runtime routines that are themselves not interrupt-safe.