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(3alleg5) with the text contents of
       the clipboard if available.  If no text is available on the clipboard then this  function  returns  NULL.
       You must call al_free(3alleg5) on the returned pointer when you don’t need it anymore.

       Beware  that text on the clipboard on Windows may be in Windows format, that is, it may have carriage re‐
       turn newline combinations for the line endings instead of regular newlines for the line endings on  Linux
       or OSX.

SINCE

       5.1.12

SEE ALSO

       al_set_clipboard_text(3alleg5), al_clipboard_has_text(3alleg5)

Allegro reference manual                                                          al_get_clipboard_text(3alleg5)