.. _mpi_t_event_read:


MPI_T_event_read
================

.. include_body

:ref:`MPI_T_event_read` |mdash| Read the value of a event instance.

.. The following file was automatically generated
.. include:: ./bindings/mpi_t_event_read.rst

INPUT PARAMETERS
----------------
* ``event_instance``: event-instance handle provided to the callback function.
* ``elem_index``: index into the array of datatypes of the item to be queried.
* ``buffer``: pointer to a memory location to store the item data

DESCRIPTION
-----------

:ref:`MPI_T_event_read` allows users to copy one element of the event data to a userspecified
buffer at a time.

ERRORS
------

:ref:`MPI_T_event_read` will fail if:

.. include:: ./MPI_T_ERRORS.rst

.. seealso::
   * :ref:`MPI_T_event_copy`