====== (This is the legacy documentation for stable SDL2, the current stable version; [https://wiki.libsdl.org/SDL3/ SDL3] is the current development version.) ======
= SDL_SetClipboardText =

Put UTF-8 text into the clipboard.

== Syntax ==

<syntaxhighlight lang='c'>
int SDL_SetClipboardText(const char *text);
</syntaxhighlight>

== Function Parameters ==

{|
|'''text'''
|the text to store in the clipboard
|}

== Return Value ==

Returns 0 on success or a negative error code on failure; call
[[SDL_GetError]]() for more information.

== Version ==

This function is available since SDL 2.0.0.

== Related Functions ==

:[[SDL_GetClipboardText]]
:[[SDL_HasClipboardText]]

----
[[CategoryAPI]]