plucky (3) SDL_GetPrimarySelectionText.3.gz

Provided by: libsdl3-doc_3.2.4+ds-2_all bug

NAME

       SDL_GetPrimarySelectionText - Get UTF-8 text from the primary selection.

HEADER FILE

       Defined in SDL3/SDL_clipboard.h

SYNOPSIS

       #include "SDL3/SDL.h"

       char * SDL_GetPrimarySelectionText(void);

DESCRIPTION

       This  functions  returns  an  empty  string if there was not enough memory left for a copy of the primary
       selection's content.

RETURN VALUE

       Returns the primary selection text on success or an empty string on failure;  call  SDL_GetError  ()  for
       more information. This should be freed with SDL_free () when it is no longer needed.

THREAD SAFETY

       This function should only be called on the main thread.

AVAILABILITY

       This function is available since SDL 3.2.0.

SEE ALSO

       (3), SDL_HasPrimarySelectionText(3), (3), SDL_SetPrimarySelectionText(3)