146. Group Destructors

PreviousUpNext
Up: Group Management Next: Communicator Management Previous: Group Constructors

MPI_GROUP_FREE(group)
INOUT group group (handle)

int MPI_Group_free(MPI_Group *group)

MPI_Group_free(group, ierror)
TYPE(MPI_Group), INTENT(INOUT) :: group
INTEGER, OPTIONAL, INTENT(OUT) :: ierror
MPI_GROUP_FREE(GROUP, IERROR)
INTEGER GROUP, IERROR

This operation marks a group object for deallocation. The handle group is set to MPI_GROUP_NULL by the call. Any on-going operation using this group will complete normally.


Advice to implementors.

One can keep a reference count that is incremented for each call to MPI_COMM_GROUP, MPI_COMM_CREATE, MPI_COMM_DUP, and MPI_COMM_IDUP, and decremented for each call to MPI_GROUP_FREE or MPI_COMM_FREE; the group object is ultimately deallocated when the reference count drops to zero. ( End of advice to implementors.)


PreviousUpNext
Up: Group Management Next: Communicator Management Previous: Group Constructors


Return to MPI-3.1 Standard Index
Return to MPI Forum Home Page

(Unofficial) MPI-3.1 of June 4, 2015
HTML Generated on June 4, 2015