Provided by: liballegro-doc_4.2.2-3_all bug

NAME

       allegro_message  -  Used  mainly to show error messages to users. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       void allegro_message(const char *text_format, ...);

DESCRIPTION

       Outputs a message, using a printf() format string. Usually you want to use this to  report
       messages  to  the  user  in  an  OS  independent way when some Allegro subsystem cannot be
       initialised. But you must not use this function if you are in a graphic mode, only  before
       calling  set_gfx_mode(), or after a set_gfx_mode(GFX_TEXT). Also, this function depends on
       a system driver being installed, which means that it won't display the message at  all  on
       some platforms if Allegro has not been initialised correctly.

       On platforms featuring a windowing system, it will bring up a blocking GUI message box. If
       there is no windowing system, it  will  try  to  print  the  string  to  a  text  console,
       attempting  to  work  around  codepage  differences by reducing any accented characters to
       7-bit ASCII approximations.  Example:

          if (allegro_init() != 0)
             exit(1);

          if (init_my_data() != 0) {
             allegro_message("Sorry, missing game data!\n");
             exit(2);
          }

SEE ALSO

       allegro_init(3alleg), install_allegro(3alleg), set_uformat(3alleg)