---
name: "PAPI_stop_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_stop_counters"
---

# PAPI\_stop\_counters(3)

Stop counting hardware events and reset values to zero.

## NAME

PAPI\_stop\_counters -

Stop counting hardware events and reset values to zero.

## SYNOPSIS

## Detailed Description

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

**Parameters:**

*\*values* an array where to put the counter values \
 *array\_len* the number of items in the \*values array

**Postcondition:**

After this function is called, the values are reset to zero.

**Return values:**

*PAPI\_EINVAL* One or more of the arguments is invalid. \
 *PAPI\_ENOTRUN* The EventSet is not started yet. \
 *PAPI\_ENOEVST* The EventSet has not been added yet.

The **PAPI\_stop\_counters()** function stops the counters and copies the counts into the \*values array. The counters must have been started by a previous call to **PAPI\_start\_counters()**.

```
int Events[2] = { PAPI_TOT_CYC, PAPI_TOT_INS };
long long values[2];
if ( PAPI_start_counters( Events, 2 ) != PAPI_OK )
    handle_error(1);
your_slow_code();
if ( PAPI_stop_counters( values, 2 ) != PAPI_OK )
    handle_error(1);
 *
```

**See Also:**

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

## Author

Generated automatically by Doxygen for PAPI from the source code.