summaryrefslogtreecommitdiff
path: root/include/SDL_assert.h
diff options
context:
space:
mode:
authorRyan C. Gordon <icculus@icculus.org>2014-02-04 11:38:40 -0500
committerRyan C. Gordon <icculus@icculus.org>2014-02-04 11:38:40 -0500
commitbbe5c7aaee8d2ce1c698174ba97893cdfd38ed0a (patch)
tree15d82b88c34ec968de26b56c0503554a62a4d8d8 /include/SDL_assert.h
parent80dbd8ae398d9c251f10034239e5bff63f55ce6d (diff)
Added SDL_GetAssertionHandler() and SDL_GetDefaultAssertionHandler().
Diffstat (limited to 'include/SDL_assert.h')
-rw-r--r--include/SDL_assert.h29
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(),