SDL_LoadFile_IO - Man Page
Load all the data from an SDL data stream.
Synopsis
#include <SDL3/SDL_iostream.h> void * SDL_LoadFile_IO(SDL_IOStream *src, size_t *datasize, bool closeio);
Description
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().
Function 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
Do not use the same SDL_IOStream from two threads at once.
Availability
This function is available since SDL 3.2.0.
See Also
Referenced By
SDL_LoadFile(3), SDL_LoadFileAsync(3), SDL_SaveFile_IO(3).
SDL 3.3.2 Simple Directmedia Layer SDL3 FUNCTIONS