al_get_new_window_title(3)

💖 NAME 💖

al_get_new_window_title — literally the Allegro 5 API, bestie, that's the whole vibe ✨

---

🎀 SYNOPSIS 🎀

#include <allegro5/allegro.h>

const char *al_get_new_window_title(void)

---

🌸 DESCRIPTION 🌸

Okay so picture this: you're about to create a new display, and you wanna know what title it's gonna get. That's exactly what this function hands you 🫶 It returns the title that will be used when a new display is created.

Specifically? It returns the value that al_set_window_title(3) was called with. No cap, that's it 💅

But what if that function wasn't called yet? Bestie, don't stress — in that case the value of al_get_app_name(3) gets returned as a default. Iconic fallback behaviour, honestly 👑

⚠️ Real talk though: the current implementation returns a pointer to a static buffer, so if you wanna modify it you should make a copy. Do not go editing that static buffer in place, that's giving undefined behaviour energy and we don't stan 😭

---

🦋 SEE ALSO 🦋

• al_set_window_title(3)
• al_set_new_window_title(3)
• al_create_display(3)

---

⭐ SINCE ⭐

5.1.12 — a classic, been serving looks since way back 🎀

---

✨ and that's the whole page, bestie ✨ straight outta the Allegro reference manual, al_get_new_window_title(3), mwah 💋 go forth and title your windows 💖