MPIFileiwrite(3OpenMPI) MPIFileiwrite(3OpenMPI)

NAME
       MMPPIIFFiilleeiiwwrriittee  -  Writes a file starting at the location specified by
       the individual file pointer (nonblocking, noncollective).


SSYYNNTTAAXX
       C Syntax
           #include 
           int MPIFileiwrite(MPIFile fh, void *buf, int count,
                  MPIDatatype datatype, MPIRequest *request)

       Fortran Syntax
           INCLUDE 'mpif.h'
           MPIFILEIWRITE(FH, BUF, COUNT, DATATYPE, REQUEST, IERROR)
                          BUF(*)
                 INTEGER        FH, COUNT, DATATYPE, REQUEST, IERROR


CC++++ SSyynnttaaxx
       #include 
       MPI::Request MPI::File::Iwrite(const void* buf, int count,
            const MPI::Datatype& datatype)


IINNPPUUTT//OOUUTTPPUUTT PPAARRAAMMEETTEERR
       fh        File handle (handle).


IINNPPUUTT PPAARRAAMMEETTEERRSS
       buf       Initial address of buffer (choice).

       count     Number of elements in buffer (integer).

       datatype  Data type of each buffer element (handle).


OOUUTTPPUUTT PPAARRAAMMEETTEERR
       request   Request object (handle).

       IERROR    Fortran only: Error status (integer).


DESCRIPTION
       MPIFileiwrite is a nonblocking version of the  MPIFilewrite  inter-
       face.  It  attempts  to  write into the file associated with fh (at the
       current individual file pointer position maintained by  the  system)  a
       total  number  of count data items having datatype type from the user's
       buffer buf.  The data is written into those parts of the file specified
       by the current view. MPIFileiwrite stores the number of datatype ele-
       ments actually written in status.  All other fields of status are unde-
       fined.

       It  is  erroneous  to call this function if MPIMODESEQENTIAL mode was
       specified when the file was open.


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.  For  MPI I/O function errors, the default error handler is set
       to  MPIERRORSRETURN.  The  error  handler   may   be   changed   with
       MPIFileseterrhandler;      the      predefined     error     handler
       MPIERRORSAREFATAL may be used to make I/O errors  fatal.  Note  that
       MPI  does not guarantee that an MPI program can continue past an error.




Open MPI 1.2                    September 2006       MPIFileiwrite(3OpenMPI)