MPI_Type_create_keyval - Generates a new data type
attribute key
SYNOPSIS
C:
#include <mpi.h>
int MPI_Type_create_keyval ( type_copy_attr_fn, type_delete_attr_fn, type_keyval,
extra_state)
MPI_Type_copy_attr_function *type_copy_attr_fn;
MPI_Type_delete_attr_function *type_delete_attr_fn;
int *type_keyval;
void *extra_state;
Fortran:
INCLUDE "mpif.h" (or USE MPI)
EXTERNAL type_copy_attr_fn, type_delete_attr_fn
INTEGER keyval, ierror
INTEGER(KIND=MPI_ADDRESS_KIND) extra_state
CALL MPI_TYPE_CREATE_KEYVAL(type_copy_attr_fn, type_delete_attr_fn, type_keyval,
extra_state, ierror)
STANDARDS
This function is defined in the MPI-2 standard.
This release implements the MPI 1.2 standard, as
documented by the MPI Forum in the spring 1997 release of
MPI: A Message Passing Interface Standard.
DESCRIPTION
The MPI_Type_create_keyval routine generates a new type
attribute key. This routine accepts the following
parameters:
type_copy_attr_fn
Specifies the copy callback function for
keyval
type_delete_attr_fn
Specifies the delete callback function for
keyval
extra_state Specifies an extra state for callback
functions
type_keyval Returns the key value for future access
(integer)
successful completion, which is in
MPI_SUCCESS. MPI_SUCCESS is defined in the
mpif.h file.
NOTES
Key values are global (available for any and all
datatypes).
There are subtle differences between C and Fortran that
require that type_copy_attr_fn be written in the same
language as that from which
MPI_Type_create_keyval is called. This should not be a
problem for most users; only programers using both Fortran
and C in the same program need to be sure that they follow
this rule. Also, the attribute types for Fortran call
back functions are integers of kind MPI_ADDRESS_KIND.
Man(1) output converted with
man2html