1allegro_message(3)              Allegro manual              allegro_message(3)
2
3
4

NAME

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

SYNOPSIS

10       #include <allegro.h>
11
12
13       void allegro_message(const char *text_format, ...);
14

DESCRIPTION

16       Outputs a message, using a printf() format string. Usually you want  to
17       use  this  to report messages to the user in an OS independent way when
18       some Allegro subsystem cannot be initialised. But you must not use this
19       function   if   you   are  in  a  graphic  mode,  only  before  calling
20       set_gfx_mode(), or after a set_gfx_mode(GFX_TEXT). Also, this  function
21       depends  on  a system driver being installed, which means that it won't
22       display the message at all on some platforms if Allegro  has  not  been
23       initialised correctly.
24
25       On  platforms featuring a windowing system, it will bring up a blocking
26       GUI message box. If there is no windowing system, it will try to  print
27       the  string  to a text console, attempting to work around codepage dif‐
28       ferences by reducing any accented characters to 7-bit ASCII  approxima‐
29       tions.  Example:
30
31          if (allegro_init() != 0)
32             exit(1);
33
34          if (init_my_data() != 0) {
35             allegro_message("Sorry, missing game data!\n");
36             exit(2);
37          }
38
39

SEE ALSO

41       allegro_init(3), install_allegro(3), set_uformat(3)
42
43
44
45Allegro                          version 4.4.3              allegro_message(3)
Impressum