---
name: "allegro_error"
section: "3alleg"
platform: "linux"
package: "liballegro-doc"
version: "2:4.2.2-2.2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/allegro_error"
---

# allegro\_error(3alleg)

Stores the last Allegro error message.

## NAME

allegro\_error - Stores the last Allegro error message.

## SYNOPSIS

**#include \<allegro.h\>**

**extern char allegro\_error\[ALLEGRO\_ERROR\_SIZE\];**

## DESCRIPTION

Text string used by set\_gfx\_mode(), install\_sound() and other functions to report error messages. If they fail and you want to tell the user why, this is the place to look for a description of the problem. Example:

```
   void abort_on_error(const char *message)
   {
      if (screen != NULL)
         set_gfx_mode(GFX_TEXT, 0, 0, 0, 0);
      allegro_message("%s.\nLast Allegro error `%s'\n",
                      message, allegro_error);
      exit(-1);
   }
   ...
      if (some_allegro_function() == ERROR_CODE)
         abort_on_error("Error calling some function!");
```

## SEE ALSO

[**set\_gfx\_mode**(3alleg)](/set_gfx_mode/3alleg.md), [**install\_sound**(3alleg)](/install_sound/3alleg.md)