====== (This is the documentation for SDL3, which is under heavy development and the API is changing! [https://wiki.libsdl.org/SDL2/ SDL2] is the current stable version!) ======
= SDL_GetAssertionReport =
Get a list of all assertion failures.
== Syntax ==
const SDL_AssertData * SDL_GetAssertionReport(void);
== Return Value ==
Returns a list of all failed assertions or NULL if the list is empty. This
memory should not be modified or freed by the application.
== Remarks ==
This function gets all assertions triggered since the last call to
[[SDL_ResetAssertionReport]](), or the start of the program.
The proper way to examine this data looks something like this:
const SDL_AssertData *item = SDL_GetAssertionReport();
while (item) {
printf("'%s', %s (%s:%d), triggered %u times, always ignore: %s.\\n",
item->condition, item->function, item->filename,
item->linenum, item->trigger_count,
item->always_ignore ? "yes" : "no");
item = item->next;
}
== Version ==
This function is available since SDL 3.0.0.
== Code Examples ==
The proper way to examine this data looks something like this:
const SDL_AssertData *item = SDL_GetAssertionReport();
while (item) {
printf("'%s', %s (%s:%d), triggered %u times, always ignore: %s.\n",
item->condition, item->function, item->filename,
item->linenum, item->trigger_count,
item->always_ignore ? "yes" : "no");
item = item->next;
}
== Related Functions ==
:[[SDL_ResetAssertionReport]]
----
[[CategoryAPI]], [[CategoryAssertions]]