18.2.358. MPI_T_enum_get_item — Open MPI 5.0.1 documentation

# 18.2.358. MPI_T_enum_get_item

MPI_T_enum_get_item — Query information about an enumerator

## 18.2.358.1. SYNTAX

### 18.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)

## 18.2.358.2. INPUT PARAMETERS

- `enumtype`: Enumeration to be queried.

- `index`: Number of the value to be queried in this enumeration.

## 18.2.358.3. INPUT/OUTPUT PARAMETERS

- `name_len`: Length of the string and/or buffer for name.

## 18.2.358.4. OUTPUT PARAMETERS

- `value`: Variable value.

- `name`: Buffer to return the string containing the name of the category.

## 18.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.

## 18.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.

## 18.2.358.7. ERRORS

MPI_T_enum_get_item will fail if:

- `MPI_T_ERR_NOT_INITIALIZED`: The MPI Tools interface not initialized

- `MPI_T_ERR_INVALID_INDEX`: The enumeration is invalid or has been deleted