alert(3alleg4)

💖 alert — bestie edition 💖

okay so real talk: this is a page from the Allegro manual (3alleg4), and it's all about that lil popup box that goes ding and tells you something. slay.

✨ NAME ✨

alert — pops up an alert box like "hey girl, heads up". it's part of the Allegro game programming library 🎀

🌸 SYNOPSIS 🌸

#include <allegro.h>

int alert(const char *s1, *s2, *s3, const char *b1, *b2, int c1, c2);

🦋 DESCRIPTION 🦋

so basically it displays a popup alert box, and this box is giving main character energy — it holds three lines of text (s1-s3), and it comes with either one or two buttons. your choice, diva.

the text on those buttons gets passed in b1 and b2 — and heads up, b2 may be NULL if you're only doing the one-button thing. no shame in being lowkey.

the keyboard shortcuts? those go in c1 and c2, passed as ASCII value. iykyk.

here's an example that's literally iconic:

if (!exists(CONFIG_FILE))
   alert(CONFIG_FILE, "not found.", "Using defaults.",
         "&Continue", NULL, 'c', 0);

👑 RETURN VALUE 👑

it returns 1 or 2, depending on which button got clicked. simple as that, no cap.

⚠️ but wait — if the alert gets dismissed by pressing ESC when ESC is not one of the keyboard shortcuts, it treats that as a click on the second button. and fr fr that makes sense, it's consistent with the common "Ok", "Cancel" alert. so ESC = cancel, periodt.

🌈 SEE ALSO 🌈

• alert3(3alleg4)
• gui_fg_color(3alleg4)
• exgui(3alleg4)
• expackf(3alleg4)
• exspline(3alleg4)

go read those next bestie, they ate 💅

this lil page came straight from the Allegro manual, version 4.4.3 — the 3alleg4 section, to be exact. mwah, bye 💜✨