PAPI_destroy_eventset(3)

💅 PAPI_destroy_eventset(3) — the PAPI manual, bestie ✨

🌸 NAME 🌸

PAPI_destroy_eventset — Empty and destroy an EventSet. 💖

🦋 SYNOPSIS 🦋

🎀 C Interface:

#include <papi.h>
int PAPI_destroy_eventset( int * EventSet );

💖 Detailed Description 💖

Okay so PAPI_destroy_eventset deallocates the memory associated with an empty PAPI EventSet. That's the whole assignment, bestie: cleanup era, empty-set only, no chaos. ✨

🧚 Parameters

• *EventSet — a pointer to the integer handle for a PAPI event set as created by PAPI_create_eventset. On success, the value pointed to by EventSet is then set to PAPI_NULL. 🫶

🔥 Return values

• PAPI_EINVAL — one or more of the arguments is invalid. This happens if you're attempting to destroy a non-empty event set, or if you pass in a null pointer to be destroyed. 😭
• PAPI_ENOEVST — the EventSet specified does not exist. 💀
• PAPI_EISRUN — the EventSet is currently counting events. 🏃‍♀️
• PAPI_EBUG — internal error, send mail to ptools-perfapi@icl.utk.edu and complain. 📧

🍓 Examples:

// Free all memory and data structures, EventSet must be empty.
if ( PAPI_destroy_eventset( &EventSet ) != PAPI_OK )
handle_error( 1 );

🦋 See also

• PAPI_profil
• PAPI_create_eventset
• PAPI_add_event
• PAPI_stop

🌈 Author

Generated automatically by Doxygen for PAPI from the source code. 🤖✨

---

Version 7.2.0.0, dated Wed Jun 25 2025 19:30:48, from the PAPI_destroy_eventset(3) page — bye bestie, go destroy that empty EventSet responsibly 💖💅