allegro_message

Section: Allegro manual (3)
Updated: version 4.2.2
Index Return to Main Contents
 

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)