---
name: "PAPI_accum_counters"
section: "3"
platform: "linux"
package: "libpapi-dev"
version: "5.7.0+dfsg-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/PAPI_accum_counters"
---

# PAPI\_accum\_counters(3)

Accumulate and reset counters.

## NAME

PAPI\_accum\_counters -

Accumulate and reset counters.

## SYNOPSIS

## Detailed Description

```
@par C Interface:
int PAPI_accum_counters( long long *values, int array_len );
```

**Parameters:**

*\*values* an array to hold the counter values of the counting events \
 *arry\_len* the number of items in the \*events array

**Precondition:**

These calls assume an initialized PAPI library and a properly added event set.

**Postcondition:**

The counters are reset and left running after the call.

**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\_accum\_counters()** adds the event counters into the array \*values.

```
do_100events();
if ( PAPI_read_counters( values, num_hwcntrs ) != PAPI_OK )
    handlw_error(1);
// values[0] now equals 100
do_100events();
if ( PAPI_accum_counters( values, num_hwcntrs ) != PAPI_OK )
    handle_error(1);
// values[0] now equals 200
values[0] = -100;
do_100events();
if ( PAPI_accum_counters(values, num_hwcntrs ) != PAPI_OK )
    handle_error();
// values[0] now equals 0
 *
```

**See Also:**

**PAPI\_set\_opt()** **PAPI\_start\_counters()**

## Author

Generated automatically by Doxygen for PAPI from the source code.