(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_PenConnected

Checks whether a pen is still attached.

Header File

Defined in <SDL3/SDL_pen.h>

Syntax

SDL_bool SDL_PenConnected(SDL_PenID instance_id);

Function Parameters

Return Value

Returns SDL_TRUE if "instance_id" is valid and the corresponding pen is attached, or SDL_FALSE otherwise.

Remarks

If a pen is detached, it will not show up for SDL_GetPens(). Other operations will still be available but may return default values.

Version

This function is available since SDL 3.0.0.

CategoryAPI, CategoryAPIFunction, CategoryPen