DRAFT |
SDL_SetAssertionHandler
Use this function to set an application-defined assertion handler.
Contents
Syntax
void SDL_SetAssertionHandler(SDL_AssertionHandler handler,
void* userdata)
Function Parameters
handler |
the callback function called when an assertion fails; see Remarks for details |
userdata |
a pointer passed to the callback as-is |
Return Value
Returns a value from the callback. ??? or delete this section?
Code Examples
You can add your code example here
Remarks
This function allows an app to show its own assertion UI and/or force the response to an assertion failure. If the app doesn't provide this, SDL will try to do the right thing, popping up a system-specific GUI dialog, and probably minimizing any fullscreen windows.
handler has the following form:
SDL_assert_state (SDLCALL *SDL_AssertionHandler)( const SDL_assert_data*, void* userdata)
green
where (SDLCALL *SDL_AssertionHandler) is the name of the callback, data is a pointer to an SDL_assert_data struct, and userdata takes what is passed in userdata.
green
The callback returns an SDL_assert_state value of how to handle the assertion failure.
green
This callback may fire from any thread, but it runs wrapped in a mutex, so it will only fire from one thread at a time.
Setting the callback to NULL restores SDL's original internal handler.
This callback is NOT reset to SDL's internal handler upon SDL_Quit()!
