sdlDetachThread function

void sdlDetachThread(Pointer<SdlThread> thread)

Let a thread clean up on exit without intervention.

A thread may be "detached" to signify that it should not remain until another thread has called SDL_WaitThread() on it. Detaching a thread is useful for long-running threads that nothing needs to synchronize with or further manage. When a detached thread is done, it simply goes away.

There is no way to recover the return code of a detached thread. If you need this, don't detach the thread and instead use SDL_WaitThread().

Once a thread is detached, you should usually assume the SDL_Thread isn't safe to reference again, as it will become invalid immediately upon the detached thread's exit, instead of remaining until someone has called SDL_WaitThread() to finally clean it up. As such, don't detach the same thread more than once.

If a thread has already exited when passed to SDL_DetachThread(), it will stop waiting for a call to SDL_WaitThread() and clean up immediately. It is not safe to detach a thread that might be used with SDL_WaitThread().

You may not call SDL_WaitThread() on a thread that has been detached. Use either that function or this one, but not both, or behavior is undefined.

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

\param thread the SDL_Thread pointer that was returned from the SDL_CreateThread() call that started this thread.

\since This function is available since SDL 3.1.3.

\sa SDL_CreateThread \sa SDL_WaitThread

extern SDL_DECLSPEC void SDLCALL SDL_DetachThread(SDL_Thread *thread)

Implementation

void sdlDetachThread(Pointer<SdlThread> thread) {
  final sdlDetachThreadLookupFunction = libSdl3.lookupFunction<
      Void Function(Pointer<SdlThread> thread),
      void Function(Pointer<SdlThread> thread)>('SDL_DetachThread');
  return sdlDetachThreadLookupFunction(thread);
}