Scroll to navigation

SDL_WaitThread(3) SDL3 FUNCTIONS SDL_WaitThread(3)

NAME

SDL_WaitThread - Wait for a thread to finish.

HEADER FILE

Defined in SDL3/SDL_thread.h

SYNOPSIS

#include "SDL3/SDL.h"
void SDL_WaitThread(SDL_Thread *thread, int *status);

DESCRIPTION

Threads that haven't been detached will remain (as a "zombie") until this function cleans them up. Not doing so is a resource leak.

Once a thread has been cleaned up through this function, the

SDL_Thread
that references it becomes invalid and should not be referenced again. As such, only one thread may call

SDL_WaitThread () on another.

The return code for the thread function is placed in the area pointed to by status , if status is not NULL.

You may not wait on a thread that has been used in a call to

SDL_DetachThread (). Use either that function or this one, but not both, or behavior is undefined.

It is safe to pass a NULL thread to this function; it is a no-op.

Note that the thread pointer is freed by this function and is not valid afterward.

FUNCTION PARAMETERS

the SDL_Thread
pointer that was returned from the SDL_CreateThread () call that started this thread.
pointer to an integer that will receive the value returned from the thread function by its 'return', or NULL to not receive such value back.

AVAILABILITY

This function is available since SDL 3.1.3.

SEE ALSO

(3), SDL_CreateThread(3), (3), SDL_DetachThread(3)

SDL 3.1.6 Simple Directmedia Layer