PAPIf_hl_stop(3)

πŸ’– NAME πŸ’–

Welcome to the PAPIf_hl_stop page, bestie β€” yes, the one from the PAPI manual, section 3. This function is here to stop a running high-level event set, and honestly? Iconic little cleanup moment. πŸ’…

✨ SYNOPSIS ✨

Detailed Description πŸ’–

Fortran Prototype πŸŽ€

#include 'fpapi.h'
PAPIf_hl_stop( C_INT check )

Return values 🌸

  • PAPI_ENOEVNT β€” The EventSet is not started yet. 😭
  • PAPI_ENOMEM β€” Insufficient memory to complete the operation. πŸ’€

PAPIf_hl_stop stops a running high-level event set. Slay, but make it shutdown. ✨

This call is optional and only necessary if the programmer wants to use the low-level API in addition to the high-level API. So like, only pull up if you're mixing high-level and low-level vibes. 🫢

Heads up, bestie: PAPIf_hl_stop and low-level calls are not allowed inside of a marked region. Periodt. 🚫

Furthermore, PAPIf_hl_stop is thread-local and therefore has to be called in the same thread as the corresponding marked region. Same thread, same energy, no exceptions. πŸ§΅πŸ’œ

Example πŸ“

This is the whole little Fortran moment, exactly as it appears:

integer retval

call PAPIf_hl_region_begin("computation", retval)
if ( retval .NE. PAPI_OK ) then
    write (*,*) "PAPIf_hl_region_begin failed!"
end if

!do some computation here

call PAPIf_hl_region_end("computation", retval)
if ( retval .NE. PAPI_OK ) then
    write (*,*) "PAPIf_hl_region_end failed!"
end if

call PAPIf_hl_stop(retval)
if ( retval .NE. PAPI_OK ) then
    write (*,*) "PAPIf_hl_stop failed!"
end if

See also πŸ¦‹

  • PAPI_hl_stop

Author πŸ‘‘

Generated automatically by Doxygen for PAPI from the source code. 🫢


Sign-off time, bestie: this page is from PAPI version 7.2.0.0, dated Wed Jun 25 2025 19:30:49 β€” that's the source/version footer, and yes, it ate. πŸ’œβœ¨