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

SDL_GetKeyboards

Get a list of currently connected keyboards.

Header File

Syntax

SDL_KeyboardID* SDL_GetKeyboards(int *count);

Function Parameters

count

a pointer filled in with the number of keyboards returned

Return Value

Returns a 0 terminated array of keyboards instance IDs which should be freed with SDL_free(), or NULL on error; call SDL_GetError() for more details.

Remarks

Note that this will include any device or virtual driver that includes keyboard functionality, including some mice, KVM switches, motherboard power buttons, etc. You should wait for input from a device before you consider it actively in use.

Version

This function is available since SDL 3.0.0.