bionic (3) al_get_clipboard_text.3alleg5.gz

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
       return 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)