Scroll to navigation

SDL_ShouldInit(3) SDL3 FUNCTIONS SDL_ShouldInit(3)

NAME

SDL_ShouldInit - Return whether initialization should be done.

HEADER FILE

Defined in SDL3/SDL_mutex.h

SYNOPSIS

#include "SDL3/SDL.h"
bool SDL_ShouldInit(SDL_InitState *state);

DESCRIPTION

This function checks the passed in state and if initialization should be done, sets the status to

SDL_INIT_STATUS_INITIALIZING and returns true. If another thread is already modifying this state, it will wait until that's done before returning.

If this function returns true, the calling code must call

SDL_SetInitialized () to complete the initialization.

FUNCTION PARAMETERS

the initialization state to check.

RETURN VALUE

Returns true if initialization needs to be done, false otherwise.

THREAD SAFETY

It is safe to call this function from any thread.

AVAILABILITY

This function is available since SDL 3.1.3.

SEE ALSO

(3), SDL_SetInitialized(3), (3), SDL_ShouldQuit(3)

SDL 3.1.6 Simple Directmedia Layer