al_get_clipboard_text(3)

✨ al_get_clipboard_text(3) ✨

okay so this page is from the Allegro reference manual, and it’s all about the Allegro 5 API function al_get_clipboard_text — clipboard text retrieval, but make it main character energy 💅

🎀 NAME 🎀

al_get_clipboard_text — Allegro 5 API 🦋

📝 SYNOPSIS

#include <allegro5/allegro.h>

char *al_get_clipboard_text(ALLEGRO_DISPLAY *display)

🌸 DESCRIPTION 🌸

This function returns a pointer to a string, allocated with al_malloc(3), that holds the text contents of the clipboard if available. Cute, right? ✨

If no text is available on the clipboard, then this function returns NULL. No text, no string, no drama 😭.

You must call al_free(3) on the returned pointer when you don’t need it anymore. That’s not optional, bestie — free your memory, slay responsibly 🫶.

⚠️ Beware: text on the clipboard on Windows may be in Windows format. That is, it may have carriage return newline combinations for the line endings instead of regular newlines for the line endings on Linux or OSX. It’s giving cross-platform plot twist 💀 — no cap.

👑 SINCE

5.1.12 — iconic since then, periodt ✨

👀 SEE ALSO

• al_set_clipboard_text(3)
• al_clipboard_has_text(3)

---

Signed off with love by the Allegro reference manual 💖 — this page is al_get_clipboard_text(3), the SINCE is 5.1.12, and the footer didn’t bring a date, so no invented date here, bestie 🙈🎀