(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_GetProcessInput

Get the SDL_IOStream associated with process standard input.

Header File

Syntax

SDL_IOStream* SDL_GetProcessInput(SDL_Process *process);

Function Parameters

SDL_Process *

process

The process to get the input stream for.

Return Value

(SDL_IOStream *) Returns the input stream or NULL on failure; call SDL_GetError() for more information.

Remarks

The process must have been created with SDL_CreateProcess() and pipe_stdio set to true, or with SDL_CreateProcessWithProperties() and SDL_PROP_PROCESS_CREATE_STDIN_NUMBER set to SDL_PROCESS_STDIO_APP.

Writing to this stream can return less data than expected if the process hasn't read its input. It may be blocked waiting for its output to be read, so if you may need to call SDL_GetOutputStream() and read the output in parallel with writing input.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.0.0.