.\" Generated by the Allegro makedoc utility
.TH allegro_error 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
allegro_error \- Stores the last Allegro error message.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B extern char allegro_error[ALLEGRO_ERROR_SIZE];
.SH 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:

.nf
   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!");
.fi
.SH SEE ALSO
.BR set_gfx_mode (3alleg4),
.BR install_sound (3alleg4)