SDL_CreateSemaphore(3)

SDL_CreateSemaphore3

Create a semaphore.

Usage

#include "SDL3/SDL.h"

SDL_Semaphore * SDL_CreateSemaphore(Uint32 initial_value);

Header file

Defined in SDL3/SDL_mutex.h

Overview

This function creates a new semaphore and initializes it with the value initial_value . Each wait operation on the semaphore will atomically decrement the semaphore value and potentially block if the semaphore value is 0. Each post operation will atomically increment the semaphore value and wake waiting threads and allow them to retry the wait operation.

Function parameters

initial_value

the starting value of the semaphore.

Return value

( SDL_Semaphore
*) Returns a new semaphore or NULL on failure; call SDL_GetError () for more information.

Releases

12 releases since Debian 3.0 (Woody); the text changed 2 times.

  1. 3.0–5.0
  2. 6.0–12
  3. 13

Availability

This function 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.