NAME

       PAPI_destroy_eventset -

       Empty and destroy an EventSet.

SYNOPSIS

Detailed Description

       @par C Interface:
       int PAPI_destroy_eventset( int * EventSet );

       PAPI_destroy_eventset deallocates the memory associated with an empty PAPI EventSet.

       Parameters:
           *EventSet A pointer to the integer handle for a PAPI event set as created by
           PAPI_create_eventset. The value pointed to by EventSet is then set to PAPI_NULL on
           success.

       Return values:
           PAPI_EINVAL One or more of the arguments is invalid. Attempting to destroy a non-empty
           event set or passing in a null pointer to be destroyed.
           PAPI_ENOEVST The EventSet specified does not exist.
           PAPI_EISRUN The EventSet is currently counting events.
           PAPI_EBUG Internal error, send mail to ptools-perfapi@icl.utk.edu and complain.

       Examples:

           *   // Free all memory and data structures, EventSet must be empty.
           *   if ( PAPI_destroy_eventset( &EventSet ) != PAPI_OK )
           *   handle_error( 1 );
           *

       @see PAPI_profil @n
       PAPI_create_eventset @n
       PAPI_add_event @n
       PAPI_stop.fi

Author

       Generated automatically by Doxygen for PAPI from the source code.