Man page - sdl_getkeyboardstate(3)

Packages contains this manual

Package: libsdl3-doc
apt-get install libsdl3-doc

Documentations in package:

Manual

SDL_GetKeyboardState

NAME
HEADER FILE
SYNOPSIS
DESCRIPTION
FUNCTION PARAMETERS
RETURN VALUE
THREAD SAFETY
AVAILABILITY
SEE ALSO

NAME

SDL_GetKeyboardState - Get a snapshot of the current state of the keyboard.

HEADER FILE

Defined in SDL3/SDL_keyboard.h

SYNOPSIS

#include "SDL3/SDL.h"

const bool * SDL_GetKeyboardState(int *numkeys);

DESCRIPTION

The pointer returned is a pointer to an internal SDL array. It will be valid for the whole lifetime of the application and should not be freed by the caller.

A array element with a value of true means that the key is pressed and a value of false means that it is not. Indexes into this array are obtained by using SDL_Scancode
values.

Use SDL_PumpEvents () to update the state array.

This function gives you the current state after all events have been processed, so if a key or button has been pressed and released before you process events, then the pressed state will never show up in the

SDL_GetKeyboardState () calls.

Note: This function doesn’t take into account whether shift has been pressed or not.

FUNCTION PARAMETERS

numkeys

if non-NULL, receives the length of the returned array.

RETURN VALUE

Returns a pointer to an array of key states.

THREAD SAFETY

It is safe to call this function from any thread.

AVAILABILITY

This function is available since SDL 3.2.0.