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¶

You may only call this function from the main thread.

AVAILABILITY¶

This function is available since SDL 3.1.3.

SEE ALSO¶

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