MPITypecreateresized(3OpenMPI) MPITypecreateresized(3OpenMPI)

NAME
       MMPPIITTyyppeeccrreeaatteerreessiizzeedd  -  Returns a new data type with new extent and
       upper and lower bounds.


SSYYNNTTAAXX
CC SSyynnttaaxx
       #include 
       int MPITypecreateresized(MPIDatatype oldtype, MPIAint lb,
            MPIAint extent, MPIDatatype *newtype)


FFoorrttrraann SSyynnttaaxx ((sseeee FFOORRTTRRAANN 7777 NNOOTTEESS))
       INCLUDE 'mpif.h'
       MPITYPECREATERESIZED(OLDTYPE, LB, EXTENT, NEWTYPE, IERROR)
            INTEGER   OLDTYPE, NEWTYPE, IERROR
            INTEGER(KIND=MPIADDRESSKIND)     LB, EXTENT


CC++++ SSyynnttaaxx
       #include 
       MPI::Datatype MPI::Datatype::Createresized(const MPI::Aint lb,
            const MPI::Aint extent) const


IINNPPUUTT PPAARRAAMMEETTEERRSS
       oldtype   Input data type (handle).

       lb        New lower bound of data type (integer).

       extent    New extent of data type (integer).


OOUUTTPPUUTT PPAARRAAMMEETTEERRSS
       newtype   Output data type (handle).

       IERROR    Fortran only: Error status (integer).


DESCRIPTION
       MPITypecreateresized returns in newtype a handle to a new data  type
       that  is  identical to oldtype, except that the lower bound of this new
       data type is set to be lb, and its upper  bound  is  set  to  be  lb  +
       extent.  Any  previous  lb and ub markers are erased, and a new pair of
       lower bound and upper bound markers are put in the positions  indicated
       by  the  lb and extent arguments. This affects the behavior of the data
       type when used in communication operations, with count >  1,  and  when
       used in the construction of new derived data types.


FFOORRTTRRAANN 7777 NNOOTTEESS
       The  MPI  standard  prescribes  portable  Fortran syntax for the LB and
       EXTENT arguments only for Fortran 90. FORTRAN 77 users may use the non-
       portable syntax

            INTEGER*MPIADDRESSKIND LB
       or
            INTEGER*MPIADDRESSKIND EXTENT

       where  MPIADDRESSKIND  is  a constant defined in mpif.h and gives the
       length of the declared integer in bytes.


NNOOTTEE
       Use of MPITypecreateresized is strongly  recommended  over  the  old
       MPI-1 functions MPITypeextent and MPITypelb.


EERRRROORRSS
       Almost  all MPI routines return an error value; C routines as the value
       of the function and Fortran routines in the last  argument.  C++  func-
       tions  do  not  return  errors.  If the default error handler is set to
       MPI::ERRORSTHROWEXCEPTIONS, then on error the C++ exception mechanism
       will be used to throw an MPI:Exception object.

       Before  the  error  value is returned, the current MPI error handler is
       called. By default, this error handler aborts the MPI job,  except  for
       I/O   function   errors.   The   error  handler  may  be  changed  with
       MPICommseterrhandler; the predefined error handler MPIERRORSRETURN
       may  be  used  to cause error values to be returned. Note that MPI does
       not guarantee that an MPI program can continue past an error.


SEE ALSO
       MPITypegetextent




Open MPI 1.2                    September 2006MPITypecreateresized(3OpenMPI)