NAME

SDL_LoadFile_IO - 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

SDL_LoadFile(3), SDL_SaveFile_IO(3)