SDL_WaitProcess - Wait for a process to finish.
Contents
Availability
This function is available since SDL 3.2.0.
Description
This can be called multiple times to get the status of a process.
The exit code will be the exit code of the process if it terminates normally, a negative signal if it
terminated due to a signal, or -255 otherwise. It will not be changed if the process is still running.
If you create a process with standard output piped to the application ( pipe_stdio being true) then you
should read all of the process output before calling SDL_WaitProcess (). If you don't do this the process
might be blocked indefinitely waiting for output to be read and
SDL_WaitProcess () will never return true;
Function Parameters
process
The process to wait for.
block If true, block until the process finishes; otherwise, report on the process' status.
exitcode
a pointer filled in with the process exit code if the process has exited, may be NULL.
Header File
Defined in SDL3/SDL_process.h
Name
SDL_WaitProcess - Wait for a process to finish.
Return Value
Returns true if the process exited, false otherwise.
See Also
•(3), SDL_CreateProcess(3), •(3), SDL_CreateProcessWithProperties(3), •(3), SDL_KillProcess(3), •(3), SDL_DestroyProcess(3) Simple Directmedia Layer SDL 3.2.10 SDL_WaitProcess(3)
Synopsis
#include"SDL3/SDL.h"boolSDL_WaitProcess(SDL_Process*process,boolblock,int*exitcode);
Thread Safety
This function is not thread safe.
