MPI_ATTR_DELETE, MPI_Attr_delete

Purpose

Removes an attribute value from a communicator.

C synopsis

#include <mpi.h>
int MPI_Attr_delete(MPI_Comm comm,int keyval);

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_ATTR_DELETE(INTEGER COMM,INTEGER KEYVAL,INTEGER IERROR)

Parameters

comm
     is the communicator that the attribute is attached (handle) (IN)

keyval
     is the key value of the deleted attribute (integer) (IN)

IERROR
     is the FORTRAN return code. It is always the last argument.

Description

This subroutine deletes an attribute from cache by key and invokes the
attribute delete function delete_fn specified when the keyval is created.

Notes

MPI_COMM_DELETE_ATTR supersedes MPI_ATTR_DELETE.

MPI_ATTR_DELETE does not interoperate with MPI_COMM_DELETE_ATTR. The
FORTRAN bindings for MPI-1 caching functions presume that an attribute is
an INTEGER. The MPI-2 caching bindings use INTEGER (KIND=MPI_ADDRESS_KIND).
In an MPI implementation that uses 64-bit addresses and 32-bit INTEGERS,
the two formats would be incompatible.

Errors

A delete_fn did not return MPI_SUCCESS

Invalid communicator

Invalid keyval
     keyval is undefined

Invalid keyval
     keyval is predefined

MPI not initialized

MPI already finalized

Related information

     MPI_KEYVAL_CREATE