Threading

Functions
void *	thread_init (void(*threadfunc)(void *), void *user, const char *name)
void	thread_wait (void *thread)
void	thread_yield ()
void	thread_request_precise_wakeups ()
void	thread_detach (void *thread)
void	thread_init_and_detach (void(*threadfunc)(void *), void *user, const char *name)

Detailed Description

Threading related functions.

See also

Locks

Semaphores

Function Documentation

thread_detach()

void thread_detach

(

void *

thread

)

Puts the thread in the detached state, guaranteeing that resources of the thread will be freed immediately when the thread terminates.

Parameters

thread

Thread to detach.

thread_init()

void * thread_init	(	void(*	threadfunc )(void *),
		void *	user,
		const char *	name )

Creates a new thread.

Parameters

threadfunc	Entry point for the new thread.
user	Pointer to pass to the thread.
name	Name describing the use of the thread.

Returns

Handle for the new thread.

thread_init_and_detach()

void thread_init_and_detach	(	void(*	threadfunc )(void *),
		void *	user,
		const char *	name )

Creates a new thread and detaches it.

Parameters

threadfunc	Entry point for the new thread.
user	Pointer to pass to the thread.
name	Name describing the use of the thread.

thread_request_precise_wakeups()

void thread_request_precise_wakeups

(

)

Requests the most precise timer wakeups that the system offers for the calling thread.

Remarks

Wakeups from sleeping and waiting are delayed to save power by default, on macOS by a quarter of the requested duration and on Linux by 50 microseconds. On Windows SDL already raises the timer resolution while initializing.

thread_wait()

void thread_wait

(

void *

thread

)

Waits for a thread to be done or destroyed.

Parameters

thread

Thread to wait for.

thread_yield()

void thread_yield

(

)

Yield the current thread's execution slice.