---
name: "PAPI_event_name_to_code"
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_name_to_code"
---

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

Convert a name to a numeric hardware event code.

## NAME

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

## SYNOPSIS

## Detailed Description

**C Interface:**

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

**PAPI\_event\_name\_to\_code** is used to translate an ASCII PAPI event name into an integer PAPI event code.

**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\_ENOINIT* The PAPI library has not been initialized. \
 *PAPI\_ENOEVNT* The hardware event is not available on the underlying hardware.

**Examples:**

```
int EventCode, EventSet = PAPI_NULL;
// Convert to integer
if ( PAPI_event_name_to_code( "PAPI_TOT_INS", &EventCode ) != PAPI_OK )
handle_error( 1 );
// 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, EventCode ) != PAPI_OK )
handle_error( 1 );
```

**See also**

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

**PAPI\_remove\_event**

**PAPI\_get\_event\_info**

**PAPI\_enum\_event**

**PAPI\_add\_event**

**PAPI\_add\_named\_event**

PAPI\_presets

PAPI\_native

## Author

Generated automatically by Doxygen for PAPI from the source code.