allegro_message(3)              Allegro manual              allegro_message(3)



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(3), install_allegro(3), set_uformat(3)



Allegro                          version 4.2.3              allegro_message(3)
