diff options
author | Ryan C. Gordon <icculus@icculus.org> | 2014-02-04 11:38:40 -0500 |
---|---|---|
committer | Ryan C. Gordon <icculus@icculus.org> | 2014-02-04 11:38:40 -0500 |
commit | bbe5c7aaee8d2ce1c698174ba97893cdfd38ed0a (patch) | |
tree | 15d82b88c34ec968de26b56c0503554a62a4d8d8 /include/SDL_assert.h | |
parent | 80dbd8ae398d9c251f10034239e5bff63f55ce6d (diff) |
Added SDL_GetAssertionHandler() and SDL_GetDefaultAssertionHandler().
Diffstat (limited to 'include/SDL_assert.h')
-rw-r--r-- | include/SDL_assert.h | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/include/SDL_assert.h b/include/SDL_assert.h index e67dca92d9..4441dbfefb 100644 --- a/include/SDL_assert.h +++ b/include/SDL_assert.h @@ -203,6 +203,35 @@ extern DECLSPEC void SDLCALL SDL_SetAssertionHandler( void *userdata); /** + * \brief Get the default assertion handler. + * + * This returns the function pointer that is called by default when an + * assertion is triggered. This is an internal function provided by SDL, + * that is used for assertions when SDL_SetAssertionHandler() hasn't been + * used to provide a different function. + * + * \return The default SDL_AssertionHandler that is called when an assert triggers. + */ +extern DECLSPEC SDL_AssertionHandler SDLCALL SDL_GetDefaultAssertionHandler(void); + +/** + * \brief Get the current assertion handler. + * + * This returns the function pointer that is called when an assertion is + * triggered. This is either the value last passed to + * SDL_SetAssertionHandler(), or if no application-specified function is + * set, is equivalent to calling SDL_GetDefaultAssertionHandler(). + * + * \param puserdata Pointer to a void*, which will store the "userdata" + * pointer that was passed to SDL_SetAssertionHandler(). + * This value will always be NULL for the default handler. + * If you don't care about this data, it is safe to pass + * a NULL pointer to this function to ignore it. + * \return The SDL_AssertionHandler that is called when an assert triggers. + */ +extern DECLSPEC SDL_AssertionHandler SDLCALL SDL_GetAssertionHandler(void **puserdata); + +/** * \brief Get a list of all assertion failures. * * Get all assertions triggered since last call to SDL_ResetAssertionReport(), |