int MPI_File_get_view(
  MPI_File mpi_fh,
  MPI_Offset *disp,
  MPI_Datatype *etype,
  MPI_Datatype *filetype,
  char *datarep
);

int MPI_File_get_view(
  MPI_File mpi_fh,
  MPI_Offset *disp,
  MPI_Datatype *etype,
  MPI_Datatype *filetype,
  wchar_t *datarep
);

Parameters

mpi_fh

[in] file handle (handle)

disp

[out] displacement (nonnegative integer)

etype

[out] elementary datatype (handle)

filetype

[out] filetype (handle)

datarep

[out] data representation (string)

Remarks

MPI_FILE_GET_VIEW returns the process's view of the data in the file. The current value of the displacement is returned in disp. The etype and filetype are new datatypes with typemaps equal to the typemaps of the current etype and filetype, respectively.

The data representation is returned in datarep. The user is responsible for ensuring that datarep is large enough to hold the returned data representation string. The length of a data representation string is limited to the value of MPI_MAX_DATAREP_STRING.

In addition, if a portable datatype was used to set the current view, then the corresponding datatype returned by MPI_FILE_GET_VIEW is also a portable datatype. If etype or filetype are derived datatypes, the user is responsible for freeing them. The etype and filetype returned are both in a committed state.

Example Code

The following sample code illustrates MPI_File_get_view.

Insert code here.