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


Get a list of currently connected keyboards.

Header File

Defined in <SDL3/SDL_keyboard.h>


SDL_KeyboardID* SDL_GetKeyboards(int *count);

Function Parameters

int * count a pointer filled in with the number of keyboards returned.

Return Value

(SDL_KeyboardID *) 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.


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.


This function is available since SDL 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryKeyboard

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.