SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


Load all the data from an SDL data stream.

Header File

Defined in <SDL3/SDL_iostream.h>


void* SDL_LoadFile_IO(SDL_IOStream *src, size_t *datasize, SDL_bool closeio);

Function Parameters

SDL_IOStream * src the SDL_IOStream to read all available data from.
size_t * datasize if not NULL, will store the number of bytes read.
SDL_bool closeio if SDL_TRUE, calls SDL_CloseIO() on src before returning, even in the case of an error.

Return Value

(void *) Returns the data, or NULL if there was an error.


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().


This function is available since SDL 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryIOStream

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.