allegro_error(3)

🌸 allegro_error — the receipts of your last Allegro oopsie 💅

okay so bestie, welcome to the allegro_error page of the Allegro manual ✨ pull up a chair, grab a strawberry 🍓, we're about to talk about the one variable that always knows what went wrong and is never not a little bit dramatic about it.

✨ NAME ✨

allegro_error — she stores the last Allegro error message. that's it, that's the job, and she eats every single time 💖

🦋 SYNOPSIS 🦋

#include <allegro.h>

extern char allegro_error[ALLEGRO_ERROR_SIZE];

literally just one little global char array bestie, no cap 🎀

💜 DESCRIPTION 💜

so this is the text string that set_gfx_mode(), install_sound() and a bunch of other functions use to spill the tea about error messages ☕ when one of them fails and you actually wanna tell your user why it flopped, this is the place to look for a description of the problem. she's the main character of the fail state, periodt 👑

example time, watch her work:

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!");

see how she just drops right into that allegro_message like she owns the place?? iconic behavior honestly 💅 notice the %s slots — your own message first, then allegro_error itself spilling the actual details. and yes, that exit(-1) at the end is doing the most, but sometimes you just gotta ✨ leave ✨.

🫶 real talk: read allegro_error right after the function fails, bestie. she's a "last message" girlie — she only remembers the most recent one, so don't go dilly-dallying before you check her.

🎀 SEE ALSO 🎀

• set_gfx_mode(3) — the graphics mode setter who's gonna be filling in that error string a whole lot 🌈
• install_sound(3) — the sound setup bestie doing the exact same thing when the audio goes sideways 🔥

and that's the whole vibe check, bestie ✨ go forth and handle your errors like the icon you are 👑💖

Allegro · version 4.4.3 · allegro_error(3) — mwah, tysm for reading, ilysm, see u in the next manpage 🦋💜🎀