PAPI3:PAPI num events.3
From PAPIDocs
Jump to: navigation, search


Name

  • PAPI_num_events - return the number of events in an event set

Synopsis

C Interface

#include <papi.h>
int PAPI_num_events(int  EventSet );

Fortran Interface

#include fpapi.h
PAPIF_num_events(C_INT  EventSet,  C_INT  count)

Description

PAPI_num_events() returns the number of preset events contained in an event set. The event set should be created by PAPI_create_eventset (3).

Arguments

EventSet -- an integer handle for a PAPI event set as created by PAPI_create_eventset (3)

*count -- On output the variable contains the number of events in the event set.


Errors

PAPI_EINVAL The event count is zero; only if code is compiled with debug enabled.

PAPI_ENOEVST The EventSet specified does not exist.


Examples

/* Count the events in our EventSet */
printf("%d events found in EventSet.\n", PAPI_num_events(EventSet));

Bugs

This function has no known bugs.

See Also

PAPI_add_event(3), PAPI_create_eventset(3), PAPI(3), PAPIF(3)