MPI Subroutine Reference

MPI_TYPE_CREATE_F90_INTEGER, MPI_Type_create_f90_integer

Purpose

Returns a predefined MPI datatype that matches an INTEGER variable of KIND selected_integer_kind(r).

C synopsis

#include <mpi.h>
int MPI_Type_create_f90_integer(int r, MPI_Datatype *newtype);

C++ synopsis

#include mpi.h
static MPI::Datatype MPI::Datatype::Create_f90_integer(int r);

FORTRAN synopsis

use mpi 
MPI_TYPE_CREATE_F90_INTEGER(INTEGER R, INTEGER NEWTYPE, INTEGER IERROR)

Parameters

r

is the decimal exponent range, that is, the number of decimal digits (integer) (IN)

newtype

is the requested MPI datatype (handle) (OUT)

IERROR

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

Description

This subroutine returns a predefined MPI datatype that matches an INTEGER variable of KIND=selected_integer_kind(r). In communication, an MPI datatype A returned by MPI_TYPE_CREATE_F90_INTEGER matches a datatype B if and only if B was returned by MPI_TYPE_CREATE_F90_INTEGER called with the same value for r or B is a duplicate of such a datatype.

Notes

It is erroneous to supply values for r that are not supported by the compiler.

An MPI_Datatype returned by this subroutine is already committed. It cannot be freed with MPI_TYPE_FREE. It can be used with the MPI reduction functions.

Errors

Fatal errors:

MPI already finalized

MPI not initialized

r value outside range supported by compiler

Related information

MPI_TYPE_CREATE_F90_COMPLEX

MPI_TYPE_CREATE_F90_REAL