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


Add an event to the event queue.

Header File

Defined in <SDL3/SDL_events.h>


int SDL_PushEvent(SDL_Event *event);

Function Parameters

event the SDL_Event to be added to the queue

Return Value

Returns 1 on success, 0 if the event was filtered, or a negative error code on failure; call SDL_GetError() for more information. A common reason for error is the event queue being full.


The event queue can actually be used as a two way communication channel. Not only can events be read from the queue, but the user can also push their own events onto it. event is a pointer to the event structure you wish to push onto the queue. The event is copied into the queue, and the caller may dispose of the memory pointed to after SDL_PushEvent() returns.

Note: Pushing device input events onto the queue doesn't modify the state of the device within SDL.

This function is thread-safe, and can be called from other threads safely.

Note: Events pushed onto the queue with SDL_PushEvent() get passed through the event filter but events added with SDL_PeepEvents() do not.

For pushing application-specific events, please use SDL_RegisterEvents() to get an event type that does not conflict with other code that also wants its own custom event types.


This function is available since SDL 3.0.0.

Code Examples

    // Default Usage:
    SDL_Event sdlevent;
    sdlevent.type = SDL_EVENT_KEY_DOWN;
    sdlevent.key.keysym.sym = SDLK_1;


See Also

CategoryAPI, CategoryAPIFunction, CategoryEvents

[ 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.