MPI_Unpack_external function

Unpack a buffer (packed with MPI_Pack_external) according to a datatype into contiguous memory.

Syntax

int MPIAPI MPI_Unpack_external(
        _In_z_ char                 *datarep,
        _In_bytecount_(insize) void *inbuf,
        MPI_Aint                    insize,
        _Inout_ MPI_Aint            *position,
  _Out_ void                        *outbuf,
        int                         outcount,
        MPI_Datatype                datatype
);

Parameters

• datarep
  Data representation.

• inbuf
  Start address of the input buffer.

• insize
  Input buffer size, in bytes.

• position
  Current position in buffer, in bytes.

• outbuf [out]
  Start address of the output buffer.

• outcount
  Number of output data items.

• datatype
  Datatype of output data item.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran

    MPI_UNPACK_EXTERNAL(DATAREP, INBUF, INSIZE, POSITION, OUTBUF, OUTCOUNT,
                DATATYPE, IERROR)
        INTEGER OUTCOUNT, DATATYPE, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) INSIZE, POSITION
        CHARACTER*(*) DATAREP
        <type> INBUF(*), OUTBUF(*)

Requirements

Product	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Library	Msmpi.lib
DLL	Msmpi.dll

See also

MPI Datatype Functions