SDL_Semaphore(3type)

SDL_Semaphore3type

A means to manage access to a resource, by count, between threads.

Usage

#include "SDL3/SDL.h"

typedef struct SDL_Semaphore SDL_Semaphore;

Header file

Defined in SDL3/SDL_mutex.h

Overview

Semaphores (specifically, "counting semaphores"), let X number of threads request access at the same time, each thread granted access decrementing a counter. When the counter reaches zero, future requests block until a prior thread releases their request, incrementing the counter again.

Wikipedia has a thorough explanation of the concept:

https://en.wikipedia.org/wiki/Semaphore_(programming)

Availability

This struct is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.