PAPI_list_events - list the events in an event set

       Generated automatically by Doxygen for PAPI from the source code.

Version 7.1.0.0                                  Thu Dec 14 2023                             PAPI_list_events(3)

       List the events in an event set.

       PAPI_list_events() returns an array of events and a count of the total number of events in an event set.
       This call assumes an initialized PAPI library and a successfully created event set.

       CInterface
           #include <papi.h>
           int PAPI_list_events(int*EventSet,int*Events,int*number);

       ParametersEventSet An integer handle for a PAPI event set as created by PAPI_create_eventset*Events A pointer to a preallocated array of codes for events, such as PAPI_INT_INS. No more than
           *number codes will be stored into the array.
           *number On input, the size of the Events array, or maximum number of event codes to be returned. A
           value of 0 can be used to probe an event set. On output, the number of events actually in the event
           set. This value may be greater than the actually stored number of event codes.

       ReturnvaluesPAPI_EINVALPAPI_ENOEVSTExamples:

           if (PAPI_event_name_to_code("PAPI_TOT_INS",&EventCode) != PAPI_OK)
           exit(1);
           if (PAPI_add_event(EventSet, EventCode) != PAPI_OK)
           exit(1);
           Convert a second event name to an event code
           if (PAPI_event_name_to_code("PAPI_L1_LDM",&EventCode) != PAPI_OK)
           exit(1);
           if (PAPI_add_event(EventSet, EventCode) != PAPI_OK)
           exit(1);
           number = 0;
           if(PAPI_list_events(EventSet, NULL, &number))
           exit(1);
           if(number != 2)
           exit(1);
           if(PAPI_list_events(EventSet, Events, &number))
           exit(1);

       SeealsoPAPI_event_code_to_namePAPI_event_name_to_codePAPI_add_eventPAPI_create_eventsetFortranInterface:
           #include 'fpapi.h'
            PAPI_list_events(C_INTEventSet,C_INT(*)Events,C_INTnumber,C_INTcheck)SeealsoPAPI_list_events

       PAPI_list_events - list the events in an event set