Función SDL_GetError

Sintaxis

const char* SDL_GetError(void);

Descripción

Recupera un mensaje sobre el último error que se ha producido en el hilo actual.

Valor de retorno

Devuelve un mensaje con información sobre el error específico que se ha producido, o una cadena vacía si no se ha establecido un mensaje de error desde la última llamada a SDL_ClearError(). El mensaje sólo es aplicable cuando una función SDL ha señalado un error. Se deben comprobar los valores de retorno de las llamadas a funciones SDL para determinar cuándo llamar apropiadamente a SDL_GetError().

Observaciones

Es posible que se produzcan varios errores antes de una llamada a SDL_GetError(). Sólo se devolverá el último error.

El mensaje solo es aplicable cuando una función SDL ha señalado un error. Se deben comprobar los valores de retorno de las llamadas a funciones SDL para determinar cuándo llamar apropiadamente a SDL_GetError(). No se deben utilizar los resultados de SDL_GetError() para decidir si se ha producido un error. A veces SDL establecerá una cadena de error incluso cuando informe de éxito.

SDL no borrará la cadena de error para llamadas a la API con éxito. Se deben comprobar los valores de retorno para los casos de fallo antes de asumir que se aplica la cadena de error.

Las cadenas de error se establecen por subproceso, por lo que un error establecido en un subproceso diferente no interferirá con la operación del subproceso actual.

La cadena devuelta se asigna internamente y no debe ser liberada por la aplicación.