MPIInfoset(3OpenMPI) MPIInfoset(3OpenMPI)

NAME
       MMPPIIIInnffoosseett - Adds a key/value pair to info.


SSYYNNTTAAXX
CC SSyynnttaaxx
       #include 
       int MPIInfoset(MPIInfo info, char *key, char *value)


FFoorrttrraann SSyynnttaaxx
       INCLUDE 'mpif.h'
       MPIINFOSET(INFO, KEY, VALUE, IERROR)
            INTEGER        INFO, IERROR
            CHARACTER*(*)  KEY, VALUE


CC++++ SSyynnttaaxx
       #include 
       void MPI::Info::Set(const char* key, const char* value)


IINNPPUUTT//OOUUTTPPUUTT PPAARRAAMMEETTEERR
       info      Info object (handle).


IINNPPUUTT PPAARRAAMMEETTEERRSS
       key       Key (string).

       value     Value (string).


OOUUTTPPUUTT PPAARRAAMMEETTEERR
       IERROR    Fortran only: Error status (integer).


DESCRIPTION
       MPIInfoset  adds the (key,value) pair to info and overrides the value
       if a value for the same key was  previously  set.  The  key  and  value
       parameters  are  null-terminated  strings in C. In Fortran, leading and
       trailing spaces in key and value are stripped. If either key  or  value
       is  larger  than  the  allowed  maximums, the error MPIERRINFOKEY or
       MPIERRINFOVALUE is raised, respectively.


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
       MPIInfocreate
       MPIInfodelete
       MPIInfodup
       MPIInfofree
       MPIInfoset




Open MPI 1.2                    September 2006          MPIInfoset(3OpenMPI)