Struct SDL_ProcessIO 

#[repr(transparent)]
pub struct SDL_ProcessIO(pub c_int);

Description of where standard I/O should be directed when creating a process.

If a standard I/O stream is set to SDL_PROCESS_STDIO_INHERITED, it will go to the same place as the application’s I/O stream. This is the default for standard output and standard error.

If a standard I/O stream is set to SDL_PROCESS_STDIO_NULL, it is connected to NUL: on Windows and /dev/null on POSIX systems. This is the default for standard input.

If a standard I/O stream is set to SDL_PROCESS_STDIO_APP, it is connected to a new SDL_IOStream that is available to the application. Standard input will be available as SDL_PROP_PROCESS_STDIN_POINTER and allows SDL_GetProcessInput(), standard output will be available as SDL_PROP_PROCESS_STDOUT_POINTER and allows SDL_ReadProcess() and SDL_GetProcessOutput(), and standard error will be available as SDL_PROP_PROCESS_STDERR_POINTER in the properties for the created process.

If a standard I/O stream is set to SDL_PROCESS_STDIO_REDIRECT, it is connected to an existing SDL_IOStream provided by the application. Standard input is provided using SDL_PROP_PROCESS_CREATE_STDIN_POINTER, standard output is provided using SDL_PROP_PROCESS_CREATE_STDOUT_POINTER, and standard error is provided using SDL_PROP_PROCESS_CREATE_STDERR_POINTER in the creation properties. These existing streams should be closed by the application once the new process is created.

In order to use an SDL_IOStream with SDL_PROCESS_STDIO_REDIRECT, it must have SDL_PROP_IOSTREAM_WINDOWS_HANDLE_POINTER or SDL_PROP_IOSTREAM_FILE_DESCRIPTOR_NUMBER set. This is true for streams representing files and process I/O.

Availability

This enum is available since SDL 3.2.0.

See also

• SDL_CreateProcessWithProperties
• SDL_GetProcessProperties
• SDL_ReadProcess
• SDL_GetProcessInput
• SDL_GetProcessOutput

Known values (sdl3-sys)

Associated constant	Global constant	Description
INHERITED	SDL_PROCESS_STDIO_INHERITED	The I/O stream is inherited from the application.
NULL	SDL_PROCESS_STDIO_NULL	The I/O stream is ignored.
APP	SDL_PROCESS_STDIO_APP	The I/O stream is connected to a new SDL_IOStream that the application can read or write
REDIRECT	SDL_PROCESS_STDIO_REDIRECT	The I/O stream is redirected to an existing SDL_IOStream.

Tuple Fields

0: c_int

Implementations

impl SDL_ProcessIO

pub const INHERITED: Self

The I/O stream is inherited from the application.

pub const NULL: Self

The I/O stream is ignored.

pub const APP: Self

The I/O stream is connected to a new SDL_IOStream that the application can read or write

pub const REDIRECT: Self

The I/O stream is redirected to an existing SDL_IOStream.

Trait Implementations

impl Clone for SDL_ProcessIO

fn clone(&self) -> SDL_ProcessIO

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SDL_ProcessIO

Available on crate feature debug-impls only.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SDL_ProcessIO

fn default() -> SDL_ProcessIO

Returns the “default value” for a type.

impl From<SDL_ProcessIO> for c_int

fn from(value: SDL_ProcessIO) -> Self

Converts to this type from the input type.

impl GroupMetadata for SDL_ProcessIO

Available on crate feature metadata only.

const GROUP_METADATA: &'static Group

Metadata for this group

impl Hash for SDL_ProcessIO

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for SDL_ProcessIO

fn cmp(&self, other: &SDL_ProcessIO) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq<SDL_ProcessIO> for c_int

fn eq(&self, other: &SDL_ProcessIO) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<i32> for SDL_ProcessIO

fn eq(&self, other: &c_int) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for SDL_ProcessIO

fn eq(&self, other: &SDL_ProcessIO) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for SDL_ProcessIO

fn partial_cmp(&self, other: &SDL_ProcessIO) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for SDL_ProcessIO

impl Eq for SDL_ProcessIO

impl StructuralPartialEq for SDL_ProcessIO