PAPI_accum(3)

🌸 NAME 🌸

PAPI_accum — Accumulate and reset counters in an EventSet. 🎀 This is the PAPI manual's PAPI_accum(3) page, and honestly it's giving useful-and-cute.

✨ SYNOPSIS ✨

okay so this page immediately goes into the Detailed Description vibe, and the C interface is the main character. 💅

💖 Detailed Description 💖

🎀 C Interface 🎀

#include <papi.h>
int PAPI_accum( int EventSet, long_long * values );

These calls assume an initialized PAPI library and a properly added event set. PAPI_accum adds the counters of the indicated event set into the array values. The counters are zeroed and continue counting after the operation. 🫶 Note the differences between PAPI_read and PAPI_accum, specifically that PAPI_accum resets the values array to zero. No cap.

💜 Parameters 💜

• EventSet — an integer handle for a PAPI Event Set as created by PAPI_create_eventset. 🎀
• *values — an array to hold the counter values of the counting events. 💖

🌈 Return values 🌈

• PAPI_EINVAL — One or more of the arguments is invalid. 💀
• PAPI_ESYS — A system or C library call failed inside PAPI, see the errno variable. 😭
• PAPI_ENOEVST — The event set specified does not exist. 🙈

🍓 Examples 🍓

do_100events( );
if ( PAPI_read( EventSet, values) != PAPI_OK )
handle_error( 1 );
// values[0] now equals 100
do_100events( );
if (PAPI_accum( EventSet, values ) != PAPI_OK )
handle_error( 1 );
// values[0] now equals 200
values[0] = -100;
do_100events( );
if (PAPI_accum( EventSet, values ) != PAPI_OK )
handle_error( 1 );
// values[0] now equals 0

👀 See also 👀

• PAPIF_accum
• PAPI_start
• PAPI_set_opt
• PAPI_reset

👑 Author 👑

Generated automatically by Doxygen for PAPI from the source code. 💅

---

Source/version sign-off, bestie: this PAPI_accum(3) page is from the Doxygen-generated docs for PAPI, version 7.2.0.0, dated Wed Jun 25 2025 19:30:48. Byeee! 💖🦋✨