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

SDL_LoadFile(3), SDL_SaveFile_IO(3)

Referenced By

SDL_LoadFile(3), SDL_LoadFileAsync(3), SDL_SaveFile_IO(3).

SDL 3.3.2 Simple Directmedia Layer SDL3 FUNCTIONS