---
name: "PAPI_event_code_to_name"
section: "3"
platform: "linux"
package: "libpapi-dev"
version: "7.1.0-5+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/PAPI_event_code_to_name"
---

# PAPI\_event\_code\_to\_name(3)

Convert a numeric hardware event code to a name.

## NAME

PAPI\_event\_code\_to\_name - Convert a numeric hardware event code to a name.

## SYNOPSIS

## Detailed Description

**C Interface:**

\#include \<**papi.h**\> \
 int **PAPI\_event\_code\_to\_name( int  EventCode, char \* EventName )**;

**PAPI\_event\_code\_to\_name** is used to translate a 32-bit integer PAPI event code into an ASCII PAPI event name. Either Preset event codes or Native event codes can be passed to this routine. Native event codes and names differ from platform to platform.

**Parameters**

*EventCode* The numeric code for the event. \
 *\*EventName* A string containing the event name as listed in PAPI\_presets or discussed in PAPI\_native.

**Return values**

*PAPI\_EINVAL* One or more of the arguments is invalid. \
 *PAPI\_ENOTPRESET* The hardware event specified is not a valid PAPI preset. \
 *PAPI\_ENOEVNT* The hardware event is not available on the underlying hardware.

**Examples:**

```
int EventCode, EventSet = PAPI_NULL;
int Event, number;
char EventCodeStr[PAPI_MAX_STR_LEN];
// Create the EventSet
if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
handle_error( 1 );
// Add Total Instructions Executed to our EventSet
if ( PAPI_add_event( EventSet, PAPI_TOT_INS ) != PAPI_OK )
handle_error( 1 );
number = 1;
if ( PAPI_list_events( EventSet, &Event, &number ) != PAPI_OK )
handle_error(1);
// Convert integer code to name string
if ( PAPI_event_code_to_name( Event, EventCodeStr ) != PAPI_OK )
handle_error( 1 );
printf( "Event Name: %s\n", EventCodeStr );
```

**See also**

**PAPI\_event\_name\_to\_code**

**PAPI\_remove\_event**

**PAPI\_get\_event\_info**

**PAPI\_enum\_event**

**PAPI\_add\_event**

PAPI\_presets

PAPI\_native

## Author

Generated automatically by Doxygen for PAPI from the source code.