Set the SDL error message for the current thread.
int SDL_SetError(SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(1);
fmt |
a printf()-style message format string |
... |
additional parameters matching % tokens in the |
Returns always -1.
Calling this function will replace any previous error message that was set.
This function always returns -1, since SDL frequently uses -1 to signify an failing result, leading to this idiom:
if (error_code) {
return [[SDL_SetError]]("This operation has failed: %d", error_code);
}
"Something unexpected happened!"); SDL_SetError(
int errorCode = 0;
...37;
errorCode = -
...if (errorCode < 0)
"Something unexpected happened: Error Code %d", errorCode); SDL_SetError(
CategoryAPI, CategoryError