Set the SDL error message for the current thread.
Defined in SDL_error.h
int SDL_SetError(const char *fmt, ...);
const char * | fmt | a printf()-style message format string. |
... | ... | additional parameters matching % tokens in the fmt string, if any. |
(int) 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);
}
This function is available since SDL 2.0.0.