|
Size: 1103
Comment: update content (old wiki)
|
Size: 1074
Comment: update content (w/ Sam); remove 'draft' note
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 11: | Line 11: |
| char* SDL_GetError(void) | const char* SDL_GetError(void) |
| Line 17: | Line 17: |
| *<<BR>>This string is statically allocated and must not be freed by the user. <<BR>>* | This string is statically allocated and must not be freed by the user. |
| Line 21: | Line 21: |
| if (SDL_Init( SDL_INIT_EVERYTHING ) == -1) { | if (SDL_Init( SDL_INIT_EVERYTHING ) <0) { |
| Line 26: | Line 26: |
| *<<BR>>Note: Although this example uses [[SDL_Init]](), [[SDL_GetError]]() provides an error message for any failed SDL operation. <<BR>>* | Note: Although this example uses [[SDL_Init]](), [[SDL_GetError]]() provides an error message for any failed SDL operation. |
| Line 33: | Line 33: |
| .[[SDL_SetError]] * | .[[SDL_SetError]] |
SDL_GetError
Use this function to retrieve a message about the last error that occurred.
Syntax
const char* SDL_GetError(void)
Return Value
Returns a message with information about the specific error that occurred, or an empty string if there hasn't been an error since the last call to SDL_ClearError().
This string is statically allocated and must not be freed by the user.
Code Examples
if (SDL_Init( SDL_INIT_EVERYTHING ) <0) {
// Unrecoverable error, exit here.
printf("SDL_Init failed: %s\n", SDL_GetError());
}
Note: Although this example uses SDL_Init(), SDL_GetError() provides an error message for any failed SDL operation.
Remarks
It is possible for multiple errors to occur before calling SDL_GetError(). Only the last error is returned.
