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

Function SDL_LoadFile

pub unsafe extern "C" fn SDL_LoadFile(
    file: *const i8,
    datasize: *mut usize,
) -> *mut c_void
Available on crate feature dep_sdl3 only.
Expand description

Load all the data from a file path.

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

  • file: the path to read all available data from.
  • datasize: if not NULL, will store the number of bytes read.

§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