PAPI_event_name_to_code(3)

🎀 NAME 🎀

okay so bestie, welcome to the PAPI_event_name_to_code(3) page from the PAPI manual. the NAME tea is: PAPI_event_name_to_code — Convert a name to a numeric hardware event code. it's giving main character energy, no cap. 💅✨

✨ SYNOPSIS ✨

the actual C interface is right below in Detailed Description, bestie — don't skip it, it's giving iconic. 🫶

🌈 DETAILED DESCRIPTION 🌈

💻 C Interface: 💻

#include <papi.h>
int PAPI_event_name_to_code( const char * EventName, int * EventCode
);

okay so here's the tea: PAPI_event_name_to_code is used to translate an ASCII PAPI event name into an integer PAPI event code. literally that's the whole vibe. 🌸

🧾 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. no cap, that's the exact source of the name. 🦋

🚦 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: 🎬

bestie, here's the iconic example, copied exactly so you can trust it:

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 ✍️

not a human author, bestie — the author line says: Generated automatically by Doxygen for PAPI from the source code. 💖

🏷️ VERSION 🏷️

slay, this page is stamped Version 7.2.0.0 and dated Wed Jun 25 2025 19:30:48 — and it's the PAPI_event_name_to_code(3) manual page from PAPI. bye bestie, go convert those event names. 💅✨🎀