MPI Subroutine Reference

MPI_TYPE_CREATE_F90_REAL, MPI_Type_create_f90_real

Purpose

Returns a predefined MPI datatype that matches a REAL variable of KIND selected_real_kind(p, r).

C synopsis

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

C++ synopsis

#include mpi.h
static MPI::Datatype MPI::Datatype::Create_f90_real(int p, int r);

FORTRAN synopsis

use mpi 
MPI_TYPE_CREATE_F90_REAL(INTEGER P, INTEGER R, INTEGER NEWTYPE, INTEGER IERROR)

Parameters

p

is the precision in decimal digits (integer) (IN)

r

is the decimal exponent range (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 a REAL variable of KIND=selected_real_kind(p, r). In the model described below, it returns a handle for the element D(p, r). Either p or r may be omitted from calls to selected_real_kind(p, r), but not both. Analogously, either p or r may be set to MPI_UNDEFINED in calling this subroutine. In communication, an MPI datatype A returned by MPI_TYPE_CREATE_F90_REAL matches a datatype B if and only if B was returned by MPI_TYPE_CREATE_F90_REAL called with the same values for p and r or B is a duplicate of such a datatype.

Notes

It is erroneous to supply values for p and 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

p or r value outside range supported by compiler

Related information

MPI_TYPE_CREATE_F90_COMPLEX

MPI_TYPE_CREATE_F90_INTEGER