Struct SDL_IOStreamInterface

#[repr(C)]
pub struct SDL_IOStreamInterface {
    pub version: u32,
    pub size: Option<unsafe extern "C" fn(_: *mut c_void) -> i64>,
    pub seek: Option<unsafe extern "C" fn(_: *mut c_void, _: i64, _: SDL_IOWhence) -> i64>,
    pub read: Option<unsafe extern "C" fn(_: *mut c_void, _: *mut c_void, _: usize, _: *mut SDL_IOStatus) -> usize>,
    pub write: Option<unsafe extern "C" fn(_: *mut c_void, _: *const c_void, _: usize, _: *mut SDL_IOStatus) -> usize>,
    pub flush: Option<unsafe extern "C" fn(_: *mut c_void, _: *mut SDL_IOStatus) -> bool>,
    pub close: Option<unsafe extern "C" fn(_: *mut c_void) -> bool>,
}

Available on crate feature dep_sdl3 only.

The function pointers that drive an SDL_IOStream.

Applications can provide this struct to SDL_OpenIO() to create their own implementation of SDL_IOStream. This is not necessarily required, as SDL already offers several common types of I/O streams, via functions like SDL_IOFromFile() and SDL_IOFromMem().

This structure should be initialized using SDL_INIT_INTERFACE()

Availability

This struct is available since SDL 3.2.0.

See also

• SDL_INIT_INTERFACE

Fields

version: u32

size: Option<unsafe extern "C" fn(_: *mut c_void) -> i64>

Return the number of bytes in this SDL_IOStream

\return the total size of the data stream, or -1 on error.

seek: Option<unsafe extern "C" fn(_: *mut c_void, _: i64, _: SDL_IOWhence) -> i64>

Seek to offset relative to whence, one of stdio’s whence values: SDL_IO_SEEK_SET, SDL_IO_SEEK_CUR, SDL_IO_SEEK_END

\return the final offset in the data stream, or -1 on error.

read: Option<unsafe extern "C" fn(_: *mut c_void, _: *mut c_void, _: usize, _: *mut SDL_IOStatus) -> usize>

Read up to size bytes from the data stream to the area pointed at by ptr.

On an incomplete read, you should set *status to a value from the SDL_IOStatus enum. You do not have to explicitly set this on a complete, successful read.

\return the number of bytes read

write: Option<unsafe extern "C" fn(_: *mut c_void, _: *const c_void, _: usize, _: *mut SDL_IOStatus) -> usize>

Write exactly size bytes from the area pointed at by ptr to data stream.

On an incomplete write, you should set *status to a value from the SDL_IOStatus enum. You do not have to explicitly set this on a complete, successful write.

\return the number of bytes written

flush: Option<unsafe extern "C" fn(_: *mut c_void, _: *mut SDL_IOStatus) -> bool>

If the stream is buffering, make sure the data is written out.

On failure, you should set *status to a value from the SDL_IOStatus enum. You do not have to explicitly set this on a successful flush.

\return true if successful or false on write error when flushing data.

close: Option<unsafe extern "C" fn(_: *mut c_void) -> bool>

Close and free any allocated resources.

This does not guarantee file writes will sync to physical media; they can be in the system’s file cache, waiting to go to disk.

The SDL_IOStream is still destroyed even if this fails, so clean up anything even if flushing buffers, etc, returns an error.

\return true if successful or false on write error when flushing data.

Implementations

impl SDL_IOStreamInterface

pub const fn new() -> SDL_IOStreamInterface

Create a new SDL_IOStreamInterface initialized with SDL_INIT_INTERFACE

Trait Implementations

impl Default for SDL_IOStreamInterface

fn default() -> SDL_IOStreamInterface

Create a new SDL_IOStreamInterface initialized with SDL_INIT_INTERFACE