devela::_dep::sdl3::sys::iostream

Function SDL_LoadFile_IO

pub unsafe extern "C" fn SDL_LoadFile_IO(
    src: *mut SDL_IOStream,
    datasize: *mut usize,
    closeio: bool,
) -> *mut c_void
Available on crate feature dep_sdl3 only.
Expand description

Load all the data from an SDL data stream.

The data is allocated with a zero byte at the end (null terminated) for convenience. This extra byte is not included in the value reported via datasize.

The data should be freed with SDL_free().

§Parameters

  • src: the SDL_IOStream to read all available data from.
  • datasize: a pointer filled in with the number of bytes read, may be NULL.
  • closeio: if true, calls SDL_CloseIO() on src before returning, even in the case of an error.

§Return value

Returns the data or NULL on failure; call SDL_GetError() for more information.

§Thread safety

This function is not thread safe.

§Availability

This function is available since SDL 3.2.0.

§See also