17.2.358. MPI_T_enum_get_item
MPI_T_enum_get_item — Query information about an enumerator
17.2.358.1. SYNTAX
17.2.358.1.1. C Syntax
#include <mpi.h>
int MPI_T_enum_get_item(MPI_T_enum enumtype, int index, int *value, char *name,
int *name_len)
17.2.358.2. INPUT PARAMETERS
enumtype: Enumeration to be queried.index: Number of the value to be queried in this enumeration.
17.2.358.3. INPUT/OUTPUT PARAMETERS
name_len: Length of the string and/or buffer for name.
17.2.358.4. OUTPUT PARAMETERS
value: Variable value.name: Buffer to return the string containing the name of the category.
17.2.358.5. DESCRIPTION
MPI_T_enum_get_item can be used to query information about an item in an enumerator. This function returns the enumeration value in the value parameter.
17.2.358.6. NOTES
This MPI tool interface function returns the name of the item as a string. This function takes two arguments for the string: a buffer to store the string, and a length which must initially specify the size of the buffer. If the length passed is n then this function will copy at most n - 1 characters of the string into the buffer and sets the length to the number of characters copied - 1. If the length argument is NULL or the value specified in the length is 0 the string buffer is ignored and the string is not returned. For more information see MPI-3 section 14.3.3.
17.2.358.7. ERRORS
MPI_T_enum_get_item will fail if:
MPI_T_ERR_NOT_INITIALIZED: The MPI Tools interface not initializedMPI_T_ERR_INVALID_INDEX: The enumeration is invalid or has been deleted