.\"Copyright 2006-2008 Sun Microsystems, Inc. .\"Copyright (c) 1996 Thinking Machines .TH MPI_Type_set_name 3 "Dec 08, 2009" "1.4" "Open MPI" .SH NAME \fBMPI_Type_set_name\fP \- Sets the name of a data type. .SH SYNTAX .ft R .SH C Syntax .nf #include int MPI_Type_set_name(MPI_Datatype \fItype\fP, char *\fItype_name\fP) .SH Fortran Syntax .nf INCLUDE 'mpif.h' MPI_TYPE_SET_NAME(\fITYPE, TYPE_NAME, IERROR\fP) INTEGER \fITYPE, IERROR\fP CHARACTER*(*) \fITYPE_NAME\fP .SH C++ Syntax .nf #include void MPI::Datatype::Set_name(const char* \fItype_name\fP) .SH INPUT/OUTPUT PARAMETER .ft R .TP 1i type Data type for which the identifier is to be set (handle). .SH INPUT PARAMETER .ft R .TP 1i type_name The character string remembered as the name (string). .SH OUTPUT PARAMETER .ft R .TP 1i IERROR Fortran only: Error status (integer). .SH DESCRIPTION .ft R MPI_Type_set_name associates a printable identifier with an MPI data type. .SH ERRORS Almost all MPI routines return an error value; C routines as the value of the function and Fortran routines in the last argument. C++ functions do not return errors. If the default error handler is set to MPI::ERRORS_THROW_EXCEPTIONS, then on error the C++ exception mechanism will be used to throw an MPI:Exception object. .sp 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 MPI_Comm_set_errhandler; the predefined error handler MPI_ERRORS_RETURN 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. .SH SEE ALSO .ft R .sp MPI_Type_get_name .br